{ "components": { "schemas": { "ApprovedSourceList": { "properties": { "sources": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" }, "kind": { "enum": [ "directory", "androidTree", "appleBookmark" ] }, "name": { "type": "string" } }, "required": [ "id", "name", "kind" ], "type": "object" }, "maxItems": 64, "type": "array" } }, "required": [ "sources" ], "type": "object" }, "ArchiveSelectionCancel": { "additionalProperties": false, "properties": { "selection": { "format": "uuid", "type": "string" } }, "required": [ "selection" ], "type": "object" }, "ArchiveSelectionPrepare": { "additionalProperties": false, "properties": { "ids": { "items": { "maxLength": 4096, "minLength": 1, "type": "string", "x-legnasend-max-utf8-bytes": 4096 }, "maxItems": 20000, "minItems": 1, "type": "array", "uniqueItems": true }, "path": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, "required": [ "path", "ids" ], "type": "object" }, "ArchiveSelectionTicket": { "additionalProperties": false, "properties": { "downloadUrl": { "description": "Same-origin integration API URL; every HEAD/GET still requires the same Authorization. Contains no credentials.", "type": "string" }, "expiresIn": { "maximum": 120, "minimum": 1, "type": "integer" }, "selectedEntries": { "maximum": 20000, "minimum": 1, "type": "integer" }, "selection": { "format": "uuid", "type": "string" } }, "required": [ "selection", "selectedEntries", "expiresIn", "downloadUrl" ], "type": "object" }, "CacheReport": { "additionalProperties": false, "properties": { "active": { "minimum": 0, "type": "integer" }, "budgetReached": { "type": "boolean" }, "entries": { "items": { "additionalProperties": false, "properties": { "disposition": { "enum": [ "candidate", "removed", "retired", "retained", "active", "failed" ], "type": "string" }, "id": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "plannedBytes": { "minimum": 0, "type": "integer" }, "reason": { "maxLength": 80, "type": "string" }, "sourceKind": { "enum": [ "unknown", "nativeReceive", "directoryUpload" ], "type": "string" }, "unlinkedBytes": { "minimum": 0, "type": "integer" } }, "required": [ "id", "sourceKind", "disposition", "reason", "plannedBytes", "unlinkedBytes" ], "type": "object" }, "maxItems": 128, "type": "array" }, "entriesTruncated": { "type": "boolean" }, "examined": { "minimum": 0, "type": "integer" }, "failed": { "minimum": 0, "type": "integer" }, "interrupted": { "type": "boolean" }, "plannedBytes": { "minimum": 0, "type": "integer" }, "removedFiles": { "minimum": 0, "type": "integer" }, "removedRecords": { "minimum": 0, "type": "integer" }, "retained": { "minimum": 0, "type": "integer" }, "unlinkedBytes": { "minimum": 0, "type": "integer" } }, "required": [ "active", "budgetReached", "entries", "entriesTruncated", "examined", "failed", "interrupted", "plannedBytes", "removedFiles", "removedRecords", "retained", "unlinkedBytes" ], "type": "object" }, "Capabilities": { "properties": { "apiVersion": { "const": 1 }, "operations": { "items": { "type": "string" }, "type": "array" }, "originalProtocol": { "type": "string" }, "product": { "const": "LegnaSend" }, "rangeDownload": { "type": "boolean" }, "readOnly": { "type": "boolean" }, "version": { "type": "string" } }, "required": [ "product", "version", "apiVersion", "operations", "rangeDownload", "readOnly", "originalProtocol" ], "type": "object" }, "ClearRequest": { "additionalProperties": false, "properties": { "expectedGeneration": { "minimum": 1, "type": "integer" }, "instanceId": { "format": "uuid", "type": "string" }, "throughSequence": { "minimum": 0, "type": "integer" } }, "required": [ "instanceId", "expectedGeneration", "throughSequence" ], "type": "object" }, "ClearResult": { "properties": { "clearedThrough": { "type": "integer" }, "generation": { "type": "integer" }, "instanceId": { "type": "string" }, "latest": { "type": "integer" }, "removed": { "type": "integer" }, "throughSequence": { "type": "integer" } }, "required": [ "instanceId", "generation", "clearedThrough", "throughSequence", "removed", "latest" ], "type": "object" }, "ConfigureWorkspaceBody": { "additionalProperties": false, "minProperties": 1, "properties": { "slug": { "maxLength": 48, "type": "string" }, "sourceId": { "format": "uuid", "type": "string" } }, "type": "object" }, "CreateWorkspaceBody": { "additionalProperties": false, "properties": { "allowUpload": { "default": false, "type": "boolean" }, "name": { "maxLength": 120, "minLength": 1, "type": "string" }, "slug": { "maxLength": 48, "type": "string" }, "sourceId": { "format": "uuid", "type": "string" }, "visible": { "default": true, "type": "boolean" } }, "required": [ "sourceId", "name", "slug" ], "type": "object" }, "Device": { "additionalProperties": false, "properties": { "alias": { "maxLength": 1024, "type": "string" }, "channels": { "items": { "$ref": "#/components/schemas/DeviceChannel" }, "maxItems": 32, "type": "array" }, "deviceType": { "enum": [ "mobile", "desktop", "web", "headless", "server" ] }, "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" } }, "required": [ "id", "alias", "deviceType", "channels" ], "type": "object" }, "DeviceChannel": { "additionalProperties": false, "properties": { "host": { "description": "Discovered IP address with optional IPv6 scope, not a caller URL", "type": "string" }, "https": { "type": "boolean" }, "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "port": { "maximum": 65535, "minimum": 1, "type": "integer" } }, "required": [ "id", "host", "port", "https" ], "type": "object" }, "DeviceList": { "additionalProperties": false, "properties": { "devices": { "items": { "$ref": "#/components/schemas/Device" }, "maxItems": 512, "type": "array" }, "localRoutes": { "description": "Choose a current UUID from localRoutes in the devices.read response; omit for automatic routing. A retired route returns 409 local_route_unavailable without fallback. Retry keeps the original task route. androidNetwork denotes per-socket binding to an identified system Network; source/interface constraints do not guarantee VPN bypass.", "items": { "$ref": "#/components/schemas/LocalRoute" }, "maxItems": 64, "type": "array" }, "scanState": { "enum": [ "idle", "running", "failed" ] }, "truncated": { "type": "boolean" } }, "required": [ "devices", "truncated", "scanState" ], "type": "object" }, "DeviceResult": { "additionalProperties": false, "properties": { "device": { "$ref": "#/components/schemas/Device" } }, "required": [ "device" ], "type": "object" }, "DocumentPreviewLease": { "additionalProperties": false, "properties": { "etag": { "pattern": "^\"[a-f0-9]{64}\"$", "type": "string" }, "lease": { "format": "uuid", "type": "string" }, "mime": { "maxLength": 256, "type": "string" }, "size": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "url": { "description": "Same-origin integration content URL with generation and lease; Authorization is still required.", "type": "string" } }, "required": [ "url", "size", "etag", "mime", "lease" ], "type": "object" }, "Entry": { "properties": { "directory": { "type": "boolean" }, "downloadable": { "type": "boolean" }, "id": { "type": "string" }, "name": { "type": "string" }, "size": { "description": "Document providers may return null for unknown size; this does not mean zero bytes.", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "id", "name", "directory", "size" ], "type": "object" }, "Error": { "properties": { "error": { "properties": { "code": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "requestId" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "FilePage": { "properties": { "anchorMissing": { "type": "boolean" }, "anchorPending": { "type": "boolean" }, "contentEpoch": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "format": "uuid", "type": [ "string", "null" ] }, "contentKnowledge": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "enum": [ "observed", "unknown" ], "type": "string" }, "contentRevision": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "cursor": { "type": [ "string", "null" ] }, "dirty": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "type": "boolean" }, "entries": { "items": { "$ref": "#/components/schemas/Entry" }, "type": "array" }, "filter": { "maxLength": 256, "type": "string" }, "generation": { "type": "integer" }, "lastObservedAt": { "description": "Last persisted observation time in Unix milliseconds; null when no value is confirmed.", "maximum": 9007199254740991, "minimum": 0, "type": [ "integer", "null" ] }, "offset": { "minimum": 0, "type": "integer" }, "path": { "type": "string" }, "scanned": { "type": "integer" }, "stamp": { "description": "Opaque directory metadata validator; not a content hash", "type": "string" } }, "required": [ "entries", "cursor", "generation", "path", "scanned", "contentEpoch", "contentKnowledge", "contentRevision", "dirty", "lastObservedAt", "filter" ], "type": "object" }, "HostSettings": { "additionalProperties": false, "properties": { "pendingRestart": { "items": { "enum": [ "alias", "verifyChecksums" ], "type": "string" }, "maxItems": 2, "type": "array", "uniqueItems": true }, "receiveCacheRetention": { "$ref": "#/components/schemas/ReceiveCacheRetention" }, "settings": { "additionalProperties": false, "properties": { "alias": { "maxLength": 120, "type": "string" }, "autoFinish": { "type": "boolean" }, "createChecksums": { "type": "boolean" }, "enableAnimations": { "type": "boolean" }, "locale": { "description": "Supported app language tag, or system", "type": "string" }, "receiveCacheRetentionDays": { "description": "Native receive crash-residue retention: -2 is exactly one hour (default), -1 waits for explicit local cleanup, 0 adds no retention delay at the next maintenance, and 1–3650 is days. Changing policy does not itself clean files. Applies only to registered inactive native remnants; grants no immediate-cleanup override, does not alter normal cancellation and does not imply resume support.", "maximum": 3650, "minimum": -2, "type": "integer" }, "theme": { "enum": [ "system", "light", "dark" ], "type": "string" }, "verifyChecksums": { "type": "boolean" } }, "required": [ "alias", "theme", "locale", "enableAnimations", "autoFinish", "createChecksums", "verifyChecksums", "receiveCacheRetentionDays" ], "type": "object" }, "version": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "version", "settings", "pendingRestart", "receiveCacheRetention" ], "type": "object" }, "KeyCreate": { "additionalProperties": false, "properties": { "expiresAt": { "minimum": 0, "type": [ "integer", "null" ] }, "grant": { "additionalProperties": false, "properties": { "scopes": { "items": { "type": "string" }, "type": "array" }, "workspaces": { "items": { "type": "string" }, "type": "array" } }, "required": [ "scopes", "workspaces" ], "type": "object" }, "name": { "maxLength": 256, "type": "string" }, "requestId": { "format": "uuid", "type": "string" }, "version": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "version", "requestId", "name", "grant", "expiresAt" ], "type": "object" }, "KeyList": { "additionalProperties": false, "properties": { "keys": { "items": { "$ref": "#/components/schemas/KeyMetadata" }, "maxItems": 128, "type": "array" }, "version": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "version", "keys" ], "type": "object" }, "KeyManage": { "additionalProperties": false, "properties": { "action": { "enum": [ "pause", "resume", "revoke" ], "type": "string" }, "requestId": { "format": "uuid", "type": "string" }, "version": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "version", "requestId", "action" ], "type": "object" }, "KeyMetadata": { "additionalProperties": false, "properties": { "createdAt": { "type": "integer" }, "enabled": { "type": "boolean" }, "expiresAt": { "type": [ "integer", "null" ] }, "grant": { "type": "object" }, "id": { "format": "uuid", "type": "string" }, "limits": { "type": [ "object", "null" ] }, "name": { "type": "string" } }, "required": [ "id", "name", "grant", "createdAt", "expiresAt", "enabled", "limits" ], "type": "object" }, "KeyReceipt": { "additionalProperties": false, "properties": { "action": { "enum": [ "create", "pause", "resume", "revoke" ], "type": "string" }, "createdAt": { "type": "integer" }, "digest": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "keyId": { "format": "uuid", "type": "string" }, "principal": { "format": "uuid", "type": "string" }, "requestId": { "format": "uuid", "type": "string" } }, "required": [ "principal", "requestId", "digest", "action", "keyId", "createdAt" ], "type": "object" }, "KeyResult": { "additionalProperties": false, "properties": { "applied": { "description": "Current listener acknowledged persisted configuration", "type": "boolean" }, "receipt": { "$ref": "#/components/schemas/KeyReceipt" }, "secret": { "description": "Only the first successful create response. Never returned by replay or receipt lookup. Store privately, not in logs.", "readOnly": true, "type": "string" }, "secretAvailable": { "type": "boolean" } }, "required": [ "receipt", "applied", "secretAvailable" ], "type": "object" }, "Limits": { "description": "0 disables only that dimension; other quotas and the global hard ceiling of 64 active responses remain enforced.", "properties": { "concurrent": { "maximum": 64, "minimum": 0, "type": "integer" }, "perMinute": { "maximum": 60000, "minimum": 0, "type": "integer" }, "perSecond": { "maximum": 1000, "minimum": 0, "type": "integer" } }, "required": [ "perSecond", "perMinute", "concurrent" ], "type": "object" }, "LocalRoute": { "additionalProperties": false, "properties": { "address": { "maxLength": 64, "type": "string" }, "binding": { "description": "Choose a current UUID from localRoutes in the devices.read response; omit for automatic routing. A retired route returns 409 local_route_unavailable without fallback. Retry keeps the original task route. androidNetwork denotes per-socket binding to an identified system Network; source/interface constraints do not guarantee VPN bypass.", "enum": [ "interfaceAndSource", "sourceOnly", "androidNetwork" ] }, "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "interfaceName": { "maxLength": 256, "type": "string" } }, "required": [ "id", "interfaceName", "address", "binding" ], "type": "object" }, "ManagedWorkspace": { "additionalProperties": false, "properties": { "allowUpload": { "type": "boolean" }, "enabled": { "type": "boolean" }, "generation": { "minimum": 1, "type": "integer" }, "id": { "format": "uuid", "type": "string" }, "invalidReason": { "enum": [ null, "missing", "notDirectory", "permissionDenied", "grantUnavailable", "ioError", "timeout" ], "type": [ "string", "null" ] }, "name": { "type": "string" }, "passwordProtected": { "type": "boolean" }, "slug": { "type": "string" }, "visible": { "type": "boolean" } }, "required": [ "id", "name", "slug", "generation", "enabled", "visible", "allowUpload", "passwordProtected", "invalidReason" ], "type": "object" }, "ManagedWorkspaceList": { "properties": { "workspaces": { "items": { "$ref": "#/components/schemas/ManagedWorkspace" }, "maxItems": 256, "type": "array" } }, "required": [ "workspaces" ], "type": "object" }, "ManagementResult": { "properties": { "destroyed": { "type": "boolean" }, "error": { "properties": { "code": { "type": "string" }, "requestId": { "format": "uuid", "type": "string" } }, "required": [ "code", "requestId" ], "type": "object" }, "id": { "format": "uuid", "type": "string" }, "workspace": { "$ref": "#/components/schemas/ManagedWorkspace" } }, "type": "object" }, "NativeTask": { "additionalProperties": false, "properties": { "actions": { "items": { "enum": [ "cancel", "accept", "reject", "remove" ] }, "type": "array" }, "bytesPerSecond": { "minimum": 0, "type": "integer" }, "direction": { "enum": [ "send", "receive" ] }, "fileCount": { "minimum": 0, "type": "integer" }, "id": { "format": "uuid", "type": "string" }, "phase": { "enum": [ "queued", "preparing", "waiting", "transferring", "succeeded", "failed", "canceled" ] }, "totalBytes": { "minimum": 0, "type": "integer" }, "transferredBytes": { "minimum": 0, "type": "integer" }, "version": { "format": "uuid", "type": "string" } }, "required": [ "id", "version", "direction", "phase", "fileCount", "totalBytes", "transferredBytes", "bytesPerSecond", "actions" ], "type": "object" }, "NativeTaskControl": { "additionalProperties": false, "properties": { "action": { "enum": [ "cancel", "accept", "reject", "remove" ], "type": "string" }, "epoch": { "format": "uuid", "type": "string" }, "version": { "format": "uuid", "type": "string" } }, "required": [ "epoch", "version", "action" ], "type": "object" }, "NativeTaskControlResult": { "additionalProperties": false, "properties": { "action": { "enum": [ "cancel", "accept", "reject", "remove" ] }, "dispatched": { "const": true }, "epoch": { "format": "uuid", "type": "string" }, "id": { "format": "uuid", "type": "string" } }, "required": [ "epoch", "id", "action", "dispatched" ], "type": "object" }, "NativeTaskList": { "additionalProperties": false, "properties": { "epoch": { "format": "uuid", "type": "string" }, "tasks": { "items": { "$ref": "#/components/schemas/NativeTask" }, "maxItems": 512, "type": "array" }, "truncated": { "type": "boolean" } }, "required": [ "epoch", "tasks", "truncated" ], "type": "object" }, "ReceiveCacheRetention": { "additionalProperties": false, "allOf": [ { "if": { "properties": { "effectiveDays": { "type": "null" } }, "required": [ "effectiveDays" ] }, "then": { "properties": { "automaticCleanupPaused": { "const": true } } } }, { "if": { "properties": { "busy": { "const": true } }, "required": [ "busy" ] }, "then": { "properties": { "automaticCleanupPaused": { "const": true } } } } ], "properties": { "automaticCleanupPaused": { "description": "Native-policy synchronization guard only. Manual retention may report false while core still retains files; Android provider cleanup is independent.", "type": "boolean" }, "busy": { "description": "A local retention update is in progress; API writes do not overwrite an in-flight change.", "type": "boolean" }, "effectiveDays": { "description": "Currently effective native retention encoding (-2 means one hour); null means unconfirmed, never inferred from the saved preference.", "maximum": 3650, "minimum": -2, "type": [ "integer", "null" ] }, "error": { "description": "Stable path-free state reason: invalid means a damaged saved preference, not invalid API input; save, apply and restore mean persistence, native apply and restoration failures; null means no error.", "enum": [ null, "invalid", "save", "apply", "restore" ], "type": [ "string", "null" ] } }, "required": [ "effectiveDays", "automaticCleanupPaused", "busy", "error" ], "type": "object" }, "RequestPage": { "properties": { "clearedThrough": { "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/components/schemas/RequestRecord" }, "type": "array" }, "generation": { "minimum": 1, "type": "integer" }, "instanceId": { "format": "uuid", "type": "string" }, "latest": { "type": "integer" }, "next": { "type": "integer" }, "oldest": { "type": [ "integer", "null" ] } }, "required": [ "entries", "next", "oldest", "latest", "generation", "clearedThrough", "instanceId" ], "type": "object" }, "RequestRecord": { "properties": { "bytes": { "minimum": 0, "type": "integer" }, "elapsedMs": { "minimum": 0, "type": "integer" }, "error": { "type": [ "string", "null" ] }, "method": { "enum": [ "GET", "HEAD", "OPTIONS", "POST", "OTHER" ], "type": "string" }, "operation": { "type": "string" }, "outcome": { "type": "string" }, "principal": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "requestId": { "format": "uuid", "type": "string" }, "sequence": { "minimum": 1, "type": "integer" }, "status": { "maximum": 599, "minimum": 100, "type": "integer" }, "timestamp": { "minimum": 0, "type": "integer" } }, "required": [ "sequence", "timestamp", "requestId", "operation", "method", "principal", "status", "outcome", "error", "reason", "bytes", "elapsedMs" ], "type": "object" }, "RetryTransferBody": { "additionalProperties": false, "properties": { "requestId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" } }, "required": [ "requestId" ], "type": "object" }, "ScanResult": { "additionalProperties": false, "properties": { "accepted": { "const": true }, "coalesced": { "type": "boolean" } }, "required": [ "accepted", "coalesced" ], "type": "object" }, "SendSelection": { "additionalProperties": false, "properties": { "files": { "items": { "additionalProperties": false, "properties": { "name": { "description": "Base name only; no native path", "maxLength": 1024, "type": "string" }, "size": { "minimum": 0, "type": "integer" } }, "required": [ "name", "size" ], "type": "object" }, "maxItems": 100, "type": "array" }, "selectionVersion": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "totalBytes": { "minimum": 0, "type": "integer" }, "totalCount": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "selectionVersion", "totalCount", "totalBytes", "truncated", "files" ], "type": "object" }, "SendTransferBody": { "additionalProperties": false, "properties": { "channelId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "deviceId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "localRouteId": { "description": "Choose a current UUID from localRoutes in the devices.read response; omit for automatic routing. A retired route returns 409 local_route_unavailable without fallback. Retry keeps the original task route. androidNetwork denotes per-socket binding to an identified system Network; source/interface constraints do not guarantee VPN bypass.", "format": "uuid", "type": "string" }, "requestId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "selectionVersion": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" } }, "required": [ "deviceId", "selectionVersion", "requestId" ], "type": "object" }, "SourceEndCleanupReceipt": { "additionalProperties": false, "allOf": [ { "if": { "properties": { "removedFiles": { "const": 0 } } }, "then": { "properties": { "unlinkedBytes": { "const": 0 } } } } ], "description": "Receiver-confirmed removal of temporary files. Logical unlinked bytes are not measured physical disk space reclaimed; published files are preserved. Absent on unconfirmed outcomes and older stored notices. Receipt IDs carry no cleanup authority.", "properties": { "receiptId": { "format": "uuid", "type": "string" }, "removedFiles": { "maximum": 2, "minimum": 0, "type": "integer" }, "unlinkedBytes": { "minimum": 0, "type": "integer" } }, "required": [ "receiptId", "removedFiles", "unlinkedBytes" ], "type": "object" }, "SourceEndNotice": { "additionalProperties": false, "allOf": [ { "if": { "required": [ "cleanup" ] }, "then": { "properties": { "state": { "enum": [ "removed", "publishedPreserved" ] } } } } ], "properties": { "attempts": { "minimum": 0, "type": "integer" }, "cleanup": { "$ref": "#/components/schemas/SourceEndCleanupReceipt" }, "id": { "format": "uuid", "type": "string" }, "name": { "maxLength": 255, "type": "string" }, "peerLabel": { "maxLength": 120, "type": "string" }, "state": { "enum": [ "pending", "waitingPeer", "sharedSource", "busy", "authorizationRequired", "removed", "publishedPreserved", "unknown", "expired", "unsupported", "superseded" ] }, "updatedAtUnixMs": { "minimum": 0, "type": "integer" }, "version": { "format": "uuid", "type": "string" } }, "required": [ "id", "version", "peerLabel", "name", "state", "attempts", "updatedAtUnixMs" ], "type": "object" }, "SourceEndNoticeList": { "additionalProperties": false, "properties": { "notices": { "items": { "$ref": "#/components/schemas/SourceEndNotice" }, "maxItems": 512, "type": "array" }, "truncated": { "type": "boolean" } }, "required": [ "notices", "truncated" ], "type": "object" }, "SourceEndRetry": { "additionalProperties": false, "properties": { "requestId": { "format": "uuid", "type": "string" }, "version": { "format": "uuid", "type": "string" } }, "required": [ "version", "requestId" ], "type": "object" }, "SourceEndRetryResult": { "additionalProperties": false, "properties": { "accepted": { "const": true }, "notice": { "$ref": "#/components/schemas/SourceEndNotice" } }, "required": [ "notice", "accepted" ], "type": "object" }, "Status": { "properties": { "activeResponses": { "minimum": 0, "type": "integer" }, "anonymousLimits": { "$ref": "#/components/schemas/Limits" }, "authRequired": { "type": "boolean" }, "enabled": { "type": "boolean" }, "fixedWindowSeconds": { "const": [ 1, 60 ] }, "globalLimits": { "$ref": "#/components/schemas/Limits" }, "https": { "type": "boolean" }, "instanceId": { "format": "uuid", "type": "string" }, "keyLimits": { "$ref": "#/components/schemas/Limits" }, "port": { "maximum": 65535, "minimum": 1, "type": "integer" }, "principal": { "type": [ "string", "null" ] }, "scopes": { "items": { "enum": [ "service.read", "workspaces.read", "files.read", "requests.read", "files.upload", "workspaces.manage", "devices.read", "devices.scan", "transfers.read", "transfers.send", "transfers.control", "cache.read", "cache.clean", "settings.read", "settings.write", "keys.manage", "requests.manage", "nativeTasks.read", "nativeTasks.control" ], "type": "string" }, "type": "array" } }, "required": [ "instanceId", "enabled", "authRequired", "port", "https", "globalLimits", "keyLimits", "anonymousLimits", "activeResponses", "principal", "scopes", "fixedWindowSeconds" ], "type": "object" }, "TransferList": { "additionalProperties": false, "properties": { "tasks": { "items": { "$ref": "#/components/schemas/TransferTask" }, "maxItems": 512, "type": "array" } }, "required": [ "tasks" ], "type": "object" }, "TransferReceipt": { "additionalProperties": false, "properties": { "replayed": { "type": "boolean" }, "task": { "$ref": "#/components/schemas/TransferTask" } }, "required": [ "task", "replayed" ], "type": "object" }, "TransferRemoval": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "removed": { "const": true } }, "required": [ "removed", "id" ], "type": "object" }, "TransferResult": { "additionalProperties": false, "properties": { "task": { "$ref": "#/components/schemas/TransferTask" } }, "required": [ "task" ], "type": "object" }, "TransferTask": { "additionalProperties": false, "properties": { "bytesPerSecond": { "minimum": 0, "type": "number" }, "deviceId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "fileCount": { "minimum": 0, "type": "integer" }, "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "localRouteId": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "removed": { "const": true }, "result": { "enum": [ "waiting", "recipientBusy", "declined", "tooManyAttempts", "sending", "finished", "finishedWithErrors", "canceledBySender", "canceledByReceiver" ] }, "retryOf": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "status": { "enum": [ "queued", "running", "succeeded", "failed", "canceled" ] }, "totalBytes": { "minimum": 0, "type": "integer" }, "transferredBytes": { "minimum": 0, "type": "integer" } }, "required": [ "id", "deviceId", "status", "fileCount", "totalBytes", "transferredBytes", "bytesPerSecond" ], "type": "object" }, "UploadReceipt": { "properties": { "directory": { "type": "boolean" }, "parent": { "description": "Document workspaces echo the requested parent ID; absent for filesystem uploads.", "type": "string" }, "path": { "type": "string" }, "sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "size": { "minimum": 0, "type": "integer" } }, "required": [ "path", "size", "sha256", "directory" ], "type": "object" }, "Workspace": { "properties": { "allowUpload": { "type": "boolean" }, "backend": { "enum": [ "filesystem", "documents" ], "type": "string" }, "capabilities": { "description": "Source-specific capabilities. Document providers support read-only listing, single-request downloads, explicit preview leases, bounded ZIP and current-directory state hints, not persistent download resume.", "properties": { "archive": { "type": "boolean" }, "capture": { "type": "boolean" }, "events": { "type": "boolean" }, "preview": { "type": "boolean" }, "resume": { "type": "boolean" }, "state": { "type": "boolean" } }, "type": "object" }, "contentEpoch": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "format": "uuid", "type": [ "string", "null" ] }, "contentKnowledge": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "enum": [ "observed", "unknown" ], "type": "string" }, "contentRevision": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "dirty": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "type": "boolean" }, "generation": { "type": "integer" }, "id": { "type": "string" }, "lastObservedAt": { "description": "Last persisted observation time in Unix milliseconds; null when no value is confirmed.", "maximum": 9007199254740991, "minimum": 0, "type": [ "integer", "null" ] }, "name": { "type": "string" }, "protected": { "type": "boolean" }, "readOnly": { "type": "boolean" }, "slug": { "type": "string" } }, "required": [ "id", "name", "slug", "generation", "readOnly", "protected", "contentEpoch", "contentKnowledge", "contentRevision", "dirty", "lastObservedAt" ], "type": "object" }, "WorkspaceDocumentSendBody": { "additionalProperties": false, "description": "Capture and verify selected document bytes before original-protocol sending; not a provider-atomic snapshot. No fabricated versions or native paths.", "properties": { "channelId": { "format": "uuid", "type": "string" }, "deviceId": { "format": "uuid", "type": "string" }, "files": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "maxItems": 128, "minItems": 1, "type": "array" }, "generation": { "minimum": 1, "type": "integer" }, "instanceId": { "format": "uuid", "type": "string" }, "localRouteId": { "description": "Choose a current UUID from localRoutes in the devices.read response; omit for automatic routing. A retired route returns 409 local_route_unavailable without fallback. Retry keeps the original task route. androidNetwork denotes per-socket binding to an identified system Network; source/interface constraints do not guarantee VPN bypass.", "format": "uuid", "type": "string" }, "requestId": { "format": "uuid", "type": "string" }, "sourceMode": { "const": "documentSnapshot" } }, "required": [ "instanceId", "generation", "deviceId", "requestId", "files", "sourceMode" ], "type": "object" }, "WorkspaceFilesystemSendBody": { "additionalProperties": false, "properties": { "channelId": { "format": "uuid", "type": "string" }, "deviceId": { "format": "uuid", "type": "string" }, "files": { "items": { "additionalProperties": false, "properties": { "id": { "maxLength": 4096, "type": "string" }, "version": { "maxLength": 256, "type": "string" } }, "required": [ "id", "version" ], "type": "object" }, "maxItems": 128, "minItems": 1, "type": "array" }, "generation": { "minimum": 1, "type": "integer" }, "instanceId": { "format": "uuid", "type": "string" }, "localRouteId": { "description": "Choose a current UUID from localRoutes in the devices.read response; omit for automatic routing. A retired route returns 409 local_route_unavailable without fallback. Retry keeps the original task route. androidNetwork denotes per-socket binding to an identified system Network; source/interface constraints do not guarantee VPN bypass.", "format": "uuid", "type": "string" }, "requestId": { "format": "uuid", "type": "string" } }, "required": [ "instanceId", "generation", "deviceId", "requestId", "files" ], "type": "object" }, "WorkspaceList": { "properties": { "workspaces": { "items": { "$ref": "#/components/schemas/Workspace" }, "type": "array" } }, "required": [ "workspaces" ], "type": "object" }, "WorkspacePasswordBody": { "oneOf": [ { "additionalProperties": false, "properties": { "password": { "format": "password", "maxLength": 128, "minLength": 4, "type": "string", "writeOnly": true } }, "required": [ "password" ], "type": "object" }, { "additionalProperties": false, "properties": { "clear": { "const": true } }, "required": [ "clear" ], "type": "object" } ] }, "WorkspaceSendBody": { "oneOf": [ { "$ref": "#/components/schemas/WorkspaceFilesystemSendBody" }, { "$ref": "#/components/schemas/WorkspaceDocumentSendBody" } ] }, "WorkspaceState": { "oneOf": [ { "properties": { "contentEpoch": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "format": "uuid", "type": [ "string", "null" ] }, "contentKnowledge": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "enum": [ "observed", "unknown" ], "type": "string" }, "contentRevision": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "dirty": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "type": "boolean" }, "entries": { "items": { "properties": { "directory": { "type": "boolean" }, "id": { "type": "string" }, "size": { "type": "integer" }, "version": { "type": [ "string", "null" ] } }, "required": [ "id", "size", "directory", "version" ], "type": "object" }, "maxItems": 64, "type": "array" }, "generation": { "type": "integer" }, "lastObservedAt": { "description": "Last persisted observation time in Unix milliseconds; null when no value is confirmed.", "maximum": 9007199254740991, "minimum": 0, "type": [ "integer", "null" ] }, "missing": { "items": { "type": "string" }, "maxItems": 64, "type": "array" }, "path": { "type": "string" }, "stamp": { "type": "string" } }, "required": [ "generation", "path", "stamp", "entries", "missing", "contentEpoch", "contentKnowledge", "contentRevision", "dirty", "lastObservedAt" ], "type": "object" }, { "description": "Short-lived document-provider current-directory invalidation hint; not a content version or incremental file list.", "properties": { "contentEpoch": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "format": "uuid", "type": [ "string", "null" ] }, "contentKnowledge": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "enum": [ "observed", "unknown" ], "type": "string" }, "contentRevision": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "dirty": { "description": "Persisted metadata observations over bounded scopes, not a whole-tree hash or file validator. Startup, pending persistence and uncertainty report unknown; notifications only request revalidation. Downloads still use per-file ETag/If-Match.", "type": "boolean" }, "generation": { "type": "integer" }, "lastObservedAt": { "description": "Last persisted observation time in Unix milliseconds; null when no value is confirmed.", "maximum": 9007199254740991, "minimum": 0, "type": [ "integer", "null" ] }, "observing": { "type": "boolean" }, "path": { "type": "string" }, "refreshFromStart": { "const": true }, "stamp": { "type": "string" }, "watchId": { "format": "uuid", "type": "string" } }, "required": [ "generation", "path", "refreshFromStart", "watchId", "stamp", "observing", "contentEpoch", "contentKnowledge", "contentRevision", "dirty", "lastObservedAt" ], "type": "object" } ] } }, "securitySchemes": { "bearerAuth": { "bearerFormat": "ls1 key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Scoped reads, keyed uploads, workspace management, host settings and cache operations, key management and native-task controls. Anonymous grants are independent and never authorize writes; the original LocalSend transfer protocol remains unchanged.", "title": "LegnaSend Integration API", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/approved-workspace-sources": { "get": { "description": "Requires an explicit workspaces.manage key and matching workspace grant. Host persistence precedes success. Revocation cancels before claim; a claimed mutation may finish after disconnect. outcome_unknown requires refreshing the catalog and comparing generation, never automatic retry. Destroy removes sharing configuration, not local files.", "operationId": "listApprovedWorkspaceSources", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApprovedSourceList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List locally approved source references without paths", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "workspaces.manage" } }, "/cache": { "get": { "description": "Requires an explicit key scope and global * grant. Cache operations affect only registered, identity-verified inactive staging; unknown or active data is retained, and paths are never accepted. Settings expose only supported non-secret fields. After a claimed mutation times out, inspect current state; do not automatically retry.", "operationId": "inspectCache", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CacheReport" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Inspect owned native receive caches without deleting", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "cache.read", "x-legnasend-workspace-grant": "*" } }, "/cache/cleanup": { "post": { "description": "Requires an explicit key scope and global * grant. Cache operations affect only registered, identity-verified inactive staging; unknown or active data is retained, and paths are never accepted. Settings expose only supported non-secret fields. After a claimed mutation times out, inspect current state; do not automatically retry.", "operationId": "cleanupCache", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CacheReport" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Clean identity-verified inactive receive caches", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "cache.clean", "x-legnasend-workspace-grant": "*" } }, "/capabilities": { "get": { "operationId": "getCapabilities", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Capabilities" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Implemented capabilities", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "service.read" } }, "/devices": { "get": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "listDevices", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeviceList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List discovered devices", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "devices.read", "x-legnasend-workspace-grant": "*" } }, "/devices/scan": { "post": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "scanDevices", "parameters": [], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScanResult" } } }, "description": "Accepted, not completed", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Start device discovery", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "devices.scan", "x-legnasend-workspace-grant": "*" } }, "/devices/{deviceId}": { "get": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "getDevice", "parameters": [ { "in": "path", "name": "deviceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeviceResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read a device and available channels", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "devices.read", "x-legnasend-workspace-grant": "*" } }, "/keys": { "get": { "description": "Requires explicit keys.manage and wildcard * on a valid key. Grants and expiry cannot exceed caller authority; self-management is forbidden. Mutations require version and requestId. Replay returns only a durable receipt, never the secret again. Reconcile unknown outcomes with the original requestId.", "operationId": "listKeys", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List key metadata within caller authority", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "keys.manage", "x-legnasend-workspace-grant": "*" } }, "/keys/create": { "post": { "description": "Requires explicit keys.manage and wildcard * on a valid key. Grants and expiry cannot exceed caller authority; self-management is forbidden. Mutations require version and requestId. Replay returns only a durable receipt, never the secret again. Reconcile unknown outcomes with the original requestId.", "operationId": "createKey", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyCreate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyResult" } } }, "description": "Key persisted and applied; one-time secret delivery", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Create a bounded-authority key with one-time secret delivery", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "keys.manage", "x-legnasend-workspace-grant": "*" } }, "/keys/requests/{requestId}": { "get": { "description": "Requires explicit keys.manage and wildcard * on a valid key. Grants and expiry cannot exceed caller authority; self-management is forbidden. Mutations require version and requestId. Replay returns only a durable receipt, never the secret again. Reconcile unknown outcomes with the original requestId.", "operationId": "getKeyReceipt", "parameters": [ { "in": "path", "name": "requestId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read a durable key operation receipt", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "keys.manage", "x-legnasend-workspace-grant": "*" } }, "/keys/{keyId}/manage": { "post": { "description": "Requires explicit keys.manage and wildcard * on a valid key. Grants and expiry cannot exceed caller authority; self-management is forbidden. Mutations require version and requestId. Replay returns only a durable receipt, never the secret again. Reconcile unknown outcomes with the original requestId.", "operationId": "manageKey", "parameters": [ { "in": "path", "name": "keyId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyManage" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Key lifecycle, authorization, version or outcome error; inspect the stable error code, never secrets or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Pause, resume or revoke another key", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "keys.manage", "x-legnasend-workspace-grant": "*" } }, "/managed-workspaces": { "get": { "description": "Requires an explicit workspaces.manage key and matching workspace grant. Host persistence precedes success. Revocation cancels before claim; a claimed mutation may finish after disconnect. outcome_unknown requires refreshing the catalog and comparing generation, never automatic retry. Destroy removes sharing configuration, not local files.", "operationId": "listManagedWorkspaces", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagedWorkspaceList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List granted persisted workspaces, including disabled entries", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "workspaces.manage" } }, "/managed-workspaces/create": { "post": { "description": "Requires an explicit workspaces.manage key and matching workspace grant. Host persistence precedes success. Revocation cancels before claim; a claimed mutation may finish after disconnect. outcome_unknown requires refreshing the catalog and comparing generation, never automatic retry. Destroy removes sharing configuration, not local files.", "operationId": "createWorkspace", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Create a closed workspace from an approved source", "x-legnasend-body-only": [ "sourceId", "password", "clear", "slug" ], "x-legnasend-max-query-bytes": 8192, "x-legnasend-no-retry": true, "x-legnasend-scope": "workspaces.manage" } }, "/native-tasks": { "get": { "description": "Requires explicit nativeTasks.read or nativeTasks.control and wildcard * on a valid key. Reads all native tasks, not just tasks created by this key. Controls require the latest epoch, id and version. Refresh after changes; never retry automatically. Accept uses local destination and file names. Remove clears terminal records, not files. No pause or resume operation.", "operationId": "listNativeTasks", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NativeTaskList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read all native send and receive tasks and speeds", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "nativeTasks.read", "x-legnasend-workspace-grant": "*" } }, "/native-tasks/source-end": { "get": { "description": "Requires a valid key, the matching nativeTasks.read/control scope and *. Returns redacted notices, never paths or cleanup credentials. Retry uses the latest version and a stable requestId; replay the exact request to reconcile an unknown outcome, use a new ID for changed input. accepted means scheduled, not remotely cleaned. Offline, shared-source, active-receive and unknown outcomes remain distinct; published files are preserved. Optional cleanup carries the receiver receipt ID, actual temporary-file removal count and logical unlinked bytes only for confirmed terminal outcomes; absence means no itemized receipt, not zero removal. These bytes do not measure physical disk space reclaimed.", "operationId": "listSourceEndNotices", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SourceEndNoticeList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read source-end notification states", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "nativeTasks.read", "x-legnasend-workspace-grant": "*" } }, "/native-tasks/source-end/{noticeId}/retry": { "post": { "description": "Requires a valid key, the matching nativeTasks.read/control scope and *. Returns redacted notices, never paths or cleanup credentials. Retry uses the latest version and a stable requestId; replay the exact request to reconcile an unknown outcome, use a new ID for changed input. accepted means scheduled, not remotely cleaned. Offline, shared-source, active-receive and unknown outcomes remain distinct; published files are preserved. Optional cleanup carries the receiver receipt ID, actual temporary-file removal count and logical unlinked bytes only for confirmed terminal outcomes; absence means no itemized receipt, not zero removal. These bytes do not measure physical disk space reclaimed.", "operationId": "retrySourceEndNotice", "parameters": [ { "in": "path", "name": "noticeId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SourceEndRetry" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SourceEndRetryResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Retry one source-end notification", "x-legnasend-key-only": true, "x-legnasend-max-body-bytes": 8192, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "nativeTasks.control", "x-legnasend-workspace-grant": "*" } }, "/native-tasks/{taskId}/control": { "post": { "description": "Requires explicit nativeTasks.read or nativeTasks.control and wildcard * on a valid key. Reads all native tasks, not just tasks created by this key. Controls require the latest epoch, id and version. Refresh after changes; never retry automatically. Accept uses local destination and file names. Remove clears terminal records, not files. No pause or resume operation.", "operationId": "controlNativeTask", "parameters": [ { "in": "path", "name": "taskId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NativeTaskControl" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NativeTaskControlResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Native task authorization, version or dispatch error; inspect stable code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Control native tasks with epoch and version checks", "x-legnasend-key-only": true, "x-legnasend-max-body-bytes": 8192, "x-legnasend-max-query-bytes": 8192, "x-legnasend-no-retry": true, "x-legnasend-scope": "nativeTasks.control", "x-legnasend-workspace-grant": "*" } }, "/openapi.json": { "get": { "operationId": "getOpenApi", "parameters": [ { "in": "query", "name": "lang", "required": false, "schema": { "default": "en", "enum": [ "en", "zh-CN", "zh-TW", "zh-HK" ], "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Current API contract", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "service.read" } }, "/requests": { "get": { "operationId": "listRequests", "parameters": [ { "in": "query", "name": "after", "required": false, "schema": { "default": 0, "minimum": 0, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestPage" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Bounded redacted request records", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "requests.read" } }, "/requests/clear": { "post": { "description": "Requires explicit requests.manage and wildcard * on a valid key. Removes only records at or below the captured watermark after matching instance and generation. Does not reset sequence, instance, quotas or active transfers; retains a clear marker and later completions.", "operationId": "clearRequests", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClearRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClearResult" } } }, "description": "Cleared observed records only", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "description": "history_changed", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Clear request history through an observed watermark", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "requests.manage", "x-legnasend-workspace-grant": "*" } }, "/send-selection": { "get": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "getSendSelection", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendSelection" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read a summary of locally selected send files", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.read", "x-legnasend-workspace-grant": "*" } }, "/settings": { "get": { "description": "Requires an explicit key scope and global * grant. Cache operations affect only registered, identity-verified inactive staging; unknown or active data is retained, and paths are never accepted. Settings expose only supported non-secret fields. After a claimed mutation times out, inspect current state; do not automatically retry.", "operationId": "readSettings", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HostSettings" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read non-secret application settings", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "settings.read", "x-legnasend-workspace-grant": "*" } }, "/settings/update": { "post": { "description": "Requires an explicit key scope and global * grant. Cache operations affect only registered, identity-verified inactive staging; unknown or active data is retained, and paths are never accepted. Settings expose only supported non-secret fields. After a claimed mutation times out, inspect current state; do not automatically retry.", "operationId": "updateSettings", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "allOf": [ { "else": { "properties": { "value": { "oneOf": [ { "maxLength": 120, "type": "string" }, { "type": "boolean" } ] } } }, "if": { "properties": { "field": { "const": "receiveCacheRetentionDays" } }, "required": [ "field" ] }, "then": { "properties": { "value": { "description": "Native receive crash-residue retention: -2 is exactly one hour (default), -1 waits for explicit local cleanup, 0 adds no retention delay at the next maintenance, and 1–3650 is days. Changing policy does not itself clean files. Applies only to registered inactive native remnants; grants no immediate-cleanup override, does not alter normal cancellation and does not imply resume support.", "maximum": 3650, "minimum": -2, "type": "integer" } } } } ], "properties": { "field": { "enum": [ "alias", "theme", "locale", "enableAnimations", "autoFinish", "createChecksums", "verifyChecksums", "receiveCacheRetentionDays" ], "type": "string" }, "value": { "oneOf": [ { "maxLength": 120, "type": "string" }, { "type": "boolean" }, { "description": "Native receive crash-residue retention: -2 is exactly one hour (default), -1 waits for explicit local cleanup, 0 adds no retention delay at the next maintenance, and 1–3650 is days. Changing policy does not itself clean files. Applies only to registered inactive native remnants; grants no immediate-cleanup override, does not alter normal cancellation and does not imply resume support.", "maximum": 3650, "minimum": -2, "type": "integer" } ] }, "version": { "pattern": "^[a-f0-9]{64}$", "type": "string" } }, "required": [ "version", "field", "value" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HostSettings" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "settings_busy means a local settings change is in progress; settings_changed means the version changed. Read current state instead of automatically retrying.", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "host_operation_failed: persistence, native apply or restoration failed; read receiveCacheRetention again for the effective state.", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Host settings, cache, authorization or outcome error; inspect the stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Update one supported setting with a version check", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "settings.write", "x-legnasend-workspace-grant": "*" } }, "/status": { "get": { "operationId": "getStatus", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Service status and non-secret budgets", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "service.read" } }, "/transfers": { "get": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "listTransfers", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List transfer tasks owned by this key", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.read", "x-legnasend-workspace-grant": "*" } }, "/transfers/send": { "post": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "sendSelection", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendTransferBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferReceipt" } } }, "description": "Accepted, not completed", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Send the current selection to a device", "x-legnasend-key-only": true, "x-legnasend-max-body-bytes": 8192, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.send", "x-legnasend-workspace-grant": "*" } }, "/transfers/{transferId}": { "get": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "getTransfer", "parameters": [ { "in": "path", "name": "transferId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read transfer task progress", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.read", "x-legnasend-workspace-grant": "*" } }, "/transfers/{transferId}/cancel": { "post": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "cancelTransfer", "parameters": [ { "in": "path", "name": "transferId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Cancel a transfer task", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.control", "x-legnasend-workspace-grant": "*" } }, "/transfers/{transferId}/remove": { "post": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success.", "operationId": "removeTransfer", "parameters": [ { "in": "path", "name": "transferId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferRemoval" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Remove a terminal transfer task record", "x-legnasend-key-only": true, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.control", "x-legnasend-workspace-grant": "*" } }, "/transfers/{transferId}/retry": { "post": { "description": "Requires an explicitly granted dedicated scope and wildcard * workspace grant on a valid key. Anonymous access, workspace passwords and single-workspace keys do not authorize these operations. Devices/channels must come from local discovery; files must come from the current local selection, never caller paths or hosts. Tasks are isolated by creating key. IDs, selection versions and idempotency receipts expire on app restart. send/retry require requestId: identical replay returns the original task; changed arguments with the same ID return 409. Retry uses whole-file original-protocol transfer, not byte resume. Revocation cancels before claim; claimed work can continue. On outcome_unknown, reconcile with the same requestId, never enqueue using a new ID. A 202 for scan/send/retry acknowledges acceptance, not discovery or delivery success. Retry requires both transfers.control and transfers.send; removing send permission prevents new transmissions.", "operationId": "retryTransfer", "parameters": [ { "in": "path", "name": "transferId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetryTransferBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferReceipt" } } }, "description": "Accepted, not completed", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Retry a terminal task; resend the entire original selection, including completed files", "x-legnasend-additional-scopes": [ "transfers.send" ], "x-legnasend-key-only": true, "x-legnasend-max-body-bytes": 8192, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.control", "x-legnasend-workspace-grant": "*" } }, "/workspaces": { "get": { "operationId": "listWorkspaces", "parameters": [], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceList" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "List granted workspaces", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "workspaces.read" } }, "/workspaces/{workspaceId}": { "get": { "operationId": "getWorkspace", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Workspace" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read a workspace descriptor", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "workspaces.read" } }, "/workspaces/{workspaceId}/archive": { "get": { "operationId": "downloadWorkspaceArchive", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "path", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "ids", "required": false, "schema": { "description": "Optional JSON array of 1–128 unique direct-child IDs under path; not filesystem paths.", "maxLength": 8192, "type": "string", "x-legnasend-max-utf8-bytes": 8192 } }, { "in": "query", "name": "selection", "required": false, "schema": { "description": "ZIP ticket created by the same authority; cannot accompany path or ids and never replaces Authorization.", "format": "uuid", "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "Sequential streaming ZIP; no source mirror or range resume", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Stream a workspace or selected entries as ZIP", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" }, "head": { "operationId": "headWorkspaceArchive", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "path", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "ids", "required": false, "schema": { "description": "Optional JSON array of 1–128 unique direct-child IDs under path; not filesystem paths.", "maxLength": 8192, "type": "string", "x-legnasend-max-utf8-bytes": 8192 } }, { "in": "query", "name": "selection", "required": false, "schema": { "description": "ZIP ticket created by the same authority; cannot accompany path or ids and never replaces Authorization.", "format": "uuid", "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "responses": { "200": { "description": "Sequential streaming ZIP; no source mirror or range resume", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Stream a workspace or selected entries as ZIP", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/cancel-archive": { "post": { "description": "Requires files.read and target workspace authority. Up to 20,000 unique direct-child IDs in 2 MiB JSON; tickets retain selectors, not ZIP bytes. The absolute 120-second admission deadline never renews and does not interrupt admitted archives; four per owner/caller, 64 globally. Cancellation stops this ticket's active streams. Do not automatically repeat a prepare whose response was lost.", "operationId": "cancelWorkspaceArchive", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSelectionCancel" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "cancelled": { "const": true } }, "required": [ "cancelled" ], "type": "object" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Cancel one exact ZIP ticket and its active streams", "x-legnasend-max-body-bytes": 1024, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/close-preview": { "post": { "description": "Requires files.read and target workspace authority. Document providers only; eight descriptor leases, 120-second idle expiry renewed by HEAD/reads. Close, generation changes and revocation end the lease. Pins one FD without mirroring; ETag identifies lease/metadata, not a content digest.", "operationId": "closeDocumentPreview", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "lease": { "format": "uuid", "type": "string" } }, "required": [ "lease" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "closed": { "type": "boolean" } }, "required": [ "closed" ], "type": "object" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Close a document preview lease owned by this authority", "x-legnasend-max-body-bytes": 1024, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/files": { "get": { "operationId": "listFiles", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "path", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "filter", "required": false, "schema": { "default": "", "maxLength": 256, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "anchor", "required": false, "schema": { "description": "File ID within this directory, supplied on the initial request only; continue with returned cursors. Bounded anchor relocation, not a numeric offset or access credential.", "maxLength": 8192, "pattern": "^[A-Za-z0-9_-]+$", "type": "string", "x-legnasend-max-utf8-bytes": 8192 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilePage" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Read a file-list page", "x-legnasend-max-query-bytes": 24576, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/files/{fileId}/content": { "get": { "operationId": "getContent", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "path", "name": "fileId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "preview", "required": false, "schema": { "enum": [ "0", "1" ], "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "version", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "lease", "required": false, "schema": { "description": "Preview lease created by this authority; not a persistent download resume version.", "format": "uuid", "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "header", "name": "Range", "required": false, "schema": { "maxLength": 1024, "type": "string", "x-legnasend-max-utf8-bytes": 1024 } }, { "in": "header", "name": "If-Match", "required": false, "schema": { "maxLength": 1024, "type": "string", "x-legnasend-max-utf8-bytes": 1024 } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } }, "application/octet-stream": { "schema": { "format": "binary", "type": "string" } } }, "description": "Original file", "headers": { "Accept-Ranges": { "schema": { "type": "string" } }, "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "minimum": 0, "type": "integer" } }, "ETag": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "206": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } }, "application/octet-stream": { "schema": { "format": "binary", "type": "string" } } }, "description": "Requested byte range", "headers": { "Accept-Ranges": { "schema": { "type": "string" } }, "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "minimum": 0, "type": "integer" } }, "Content-Range": { "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "416": { "description": "Unsatisfiable byte range", "headers": { "Content-Range": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Original file bytes and ranges", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" }, "head": { "operationId": "headContent", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "path", "name": "fileId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "preview", "required": false, "schema": { "enum": [ "0", "1" ], "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "version", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "lease", "required": false, "schema": { "description": "Preview lease created by this authority; not a persistent download resume version.", "format": "uuid", "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "header", "name": "Range", "required": false, "schema": { "maxLength": 1024, "type": "string", "x-legnasend-max-utf8-bytes": 1024 } }, { "in": "header", "name": "If-Match", "required": false, "schema": { "maxLength": 1024, "type": "string", "x-legnasend-max-utf8-bytes": 1024 } } ], "responses": { "200": { "description": "Original file", "headers": { "Accept-Ranges": { "schema": { "type": "string" } }, "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "minimum": 0, "type": "integer" } }, "ETag": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "206": { "description": "Requested byte range", "headers": { "Accept-Ranges": { "schema": { "type": "string" } }, "Content-Disposition": { "schema": { "type": "string" } }, "Content-Length": { "schema": { "minimum": 0, "type": "integer" } }, "Content-Range": { "schema": { "type": "string" } }, "ETag": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "416": { "description": "Unsatisfiable byte range", "headers": { "Content-Range": { "schema": { "type": "string" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Original file bytes and ranges", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/manage": { "post": { "description": "Requires an explicit workspaces.manage key and matching workspace grant. Host persistence precedes success. Revocation cancels before claim; a claimed mutation may finish after disconnect. outcome_unknown requires refreshing the catalog and comparing generation, never automatic retry. Destroy removes sharing configuration, not local files.", "operationId": "manageWorkspace", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "action", "required": true, "schema": { "enum": [ "update", "enable", "disable", "validate", "destroy", "configure", "password" ], "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "name", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "visible", "required": false, "schema": { "type": "boolean", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "allowUpload", "required": false, "schema": { "type": "boolean", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ConfigureWorkspaceBody" }, { "$ref": "#/components/schemas/WorkspacePasswordBody" } ] } } }, "required": false }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagementResult" } } }, "description": "Host, authorization, generation or outcome state; inspect stable error code", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Compare generation then update, enable, disable, validate or destroy workspace configuration", "x-legnasend-body-only": [ "sourceId", "password", "clear", "slug" ], "x-legnasend-max-query-bytes": 8192, "x-legnasend-no-retry": true, "x-legnasend-scope": "workspaces.manage" } }, "/workspaces/{workspaceId}/prepare-archive": { "post": { "description": "Requires files.read and target workspace authority. Up to 20,000 unique direct-child IDs in 2 MiB JSON; tickets retain selectors, not ZIP bytes. The absolute 120-second admission deadline never renews and does not interrupt admitted archives; four per owner/caller, 64 globally. Cancellation stops this ticket's active streams. Do not automatically repeat a prepare whose response was lost.", "operationId": "prepareWorkspaceArchive", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSelectionPrepare" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveSelectionTicket" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Prepare a short-lived large-selection ZIP ticket", "x-legnasend-max-body-bytes": 2097152, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/prepare-preview": { "post": { "description": "Requires files.read and target workspace authority. Document providers only; eight descriptor leases, 120-second idle expiry renewed by HEAD/reads. Close, generation changes and revocation end the lease. Pins one FD without mirroring; ETag identifies lease/metadata, not a content digest.", "operationId": "prepareDocumentPreview", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "type": "string" } }, "required": [ "id" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentPreviewLease" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Prepare a read-only document-provider preview lease", "x-legnasend-max-body-bytes": 1024, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/send": { "post": { "description": "Requires transfers.send and files.read plus wildcard * on a valid key. Uses the current service instanceId, workspace generation, at most 128 listed file IDs with exact quoted ETag versions and discovered device/channel IDs. No paths, URLs, IPs or implicit folder recursion. Host verifies and snapshots sources before queuing the original LocalSend protocol, leaving UI selection untouched. 202 means queued, not delivered. Replay the same requestId to reconcile; never use a new ID after an unknown outcome.", "operationId": "sendWorkspaceFiles", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceSendBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferReceipt" } } }, "description": "Accepted, not completed", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable authorization, validation, host or task-state error", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Send versioned workspace files to a discovered device", "x-legnasend-additional-scopes": [ "files.read" ], "x-legnasend-key-only": true, "x-legnasend-max-body-bytes": 65536, "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "transfers.send", "x-legnasend-workspace-grant": "*" } }, "/workspaces/{workspaceId}/state": { "get": { "operationId": "getWorkspaceState", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "path", "required": false, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "ids", "required": false, "schema": { "description": "At most 64 comma-separated canonical ASCII file IDs in the requested directory, totaling at most 8192 bytes; not local paths or URLs", "maxLength": 8192, "pattern": "^(?:[A-Za-z0-9_-]+(?:,[A-Za-z0-9_-]+){0,63})?$", "type": "string", "x-legnasend-max-utf8-bytes": 8192 } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceState" } } }, "description": "OK", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Validate directory state and versions of up to 64 visible files", "x-legnasend-max-query-bytes": 24576, "x-legnasend-scope": "files.read" } }, "/workspaces/{workspaceId}/upload": { "post": { "description": "Requires a valid key with files.upload and a matching workspace grant, never anonymous or browser-cookie authorization. Independent of browser allowUpload. Exact Content-Length is required; directory=true creates an empty directory with a zero-byte body. Generation/key/workspace revocation aborts unpublished data. Retry sends the whole file.", "operationId": "uploadFile", "parameters": [ { "in": "path", "name": "workspaceId", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "generation", "required": true, "schema": { "minimum": 1, "type": "integer", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "path", "required": true, "schema": { "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "directory", "required": false, "schema": { "default": false, "type": "boolean", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "query", "name": "parent", "required": false, "schema": { "default": "", "description": "Target parent directory ID for document-provider workspaces; empty means the root. path is relative to this directory, never a content URI. Filesystem workspaces require this omitted or empty.", "maxLength": 4096, "type": "string", "x-legnasend-max-utf8-bytes": 4096 } }, { "in": "header", "name": "Content-Length", "required": true, "schema": { "minimum": 0, "type": "integer" } } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "format": "binary", "type": "string" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UploadReceipt" } } }, "description": "Created and published", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid path or body", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid, expired or revoked key", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Missing upload or workspace grant", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Workspace unavailable", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Existing destination or stale generation", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "411": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Exact Content-Length required", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "415": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "application/octet-stream required", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Fixed second/minute or concurrent-response budget", "headers": { "Retry-After": { "schema": { "minimum": 1, "type": "integer" } }, "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stable error code; no credentials or local paths", "headers": { "X-LegnaSend-Remaining-Minute": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Remaining-Second": { "description": "4294967295 means both global and caller quotas are unlimited in this dimension; otherwise the smaller finite remainder.", "schema": { "maximum": 4294967295, "minimum": 0, "type": "integer" } }, "X-LegnaSend-Request-Id": { "schema": { "format": "uuid", "type": "string" } } } } }, "summary": "Stream a new file or empty directory with an explicit upload key; never overwrite", "x-legnasend-max-query-bytes": 8192, "x-legnasend-scope": "files.upload" } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "/api/legnasend/v1/integration" } ], "x-legnasend-anonymous-policy": "When business authentication is disabled, anonymous grants apply only to visible, unprotected workspaces. A supplied invalid token never falls back to anonymous." }