{"openapi":"3.0.3","info":{"title":"Pipeline Backend","version":"0.1.0"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{}},"paths":{"/healthz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/readyz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customers":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"storageProvider":{"type":"string","enum":["azure_blob","gcs","localfs"]},"storageAccount":{"type":"string","minLength":1},"storageContainer":{"type":"string","minLength":1},"logoUrl":{"type":"string","format":"uri","minLength":1},"metadata":{"type":"object","additionalProperties":{}}},"required":["slug","name"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customers/{customerId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"customerId","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"slug":{"type":"string","minLength":1},"status":{"type":"string","enum":["active","disabled"]},"storageProvider":{"type":"string","enum":["azure_blob","gcs","localfs"],"nullable":true},"storageAccount":{"type":"string","minLength":1,"nullable":true},"storageContainer":{"type":"string","minLength":1,"nullable":true},"logoUrl":{"type":"string","format":"uri","minLength":1,"nullable":true},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"customerId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"customerId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/sites":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"slug":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"address":{"type":"string","minLength":1,"nullable":true},"timezone":{"type":"string","minLength":1,"default":"UTC"},"metadata":{"type":"object","additionalProperties":{}},"scanSource":{"type":"string","enum":["db","scandrop"],"nullable":true},"customerDatabase":{"type":"object","properties":{"scanQuery":{"type":"string","nullable":true},"scanQueryAutodetect":{"type":"boolean","default":false},"timezone":{"type":"string","minLength":1,"default":"UTC"}},"nullable":true},"scanFields":{"type":"object","properties":{"xField":{"type":"string","default":"locXPos"},"yField":{"type":"string","default":"locYPos"},"zField":{"type":"string","nullable":true,"default":null},"zDefaultCm":{"type":"number","default":100},"zoneField":{"type":"string","nullable":true,"default":null},"handlingUnitField":{"type":"string","default":"handlingUnitId"},"shipmentField":{"type":"string","nullable":true,"default":null}},"nullable":true},"captureConfig":{"type":"object","properties":{"pollIntervalSeconds":{"type":"number","default":2},"toleranceSeconds":{"type":"number","default":2},"scanLookbackSeconds":{"type":"number","default":300},"localFrameTtlHours":{"type":"number","default":48},"bufferHardMaxSeconds":{"type":"number","default":600},"bufferFps":{"type":"number","default":30},"fovMarginSide":{"type":"number","default":0.05},"fovMarginTop":{"type":"number","default":0.2}},"nullable":true},"scandropConfig":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"directory":{"type":"string"},"processedDirectory":{"type":"string"}},"nullable":true}},"required":["customerId","name"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/sites/{siteId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"siteId","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"slug":{"type":"string","minLength":1},"address":{"type":"string","minLength":1,"nullable":true},"timezone":{"type":"string","minLength":1},"metadata":{"type":"object","additionalProperties":{}},"scanSource":{"type":"string","enum":["db","scandrop"],"nullable":true},"customerDatabase":{"type":"object","properties":{"scanQuery":{"type":"string","nullable":true},"scanQueryAutodetect":{"type":"boolean","default":false},"timezone":{"type":"string","minLength":1,"default":"UTC"}},"nullable":true},"scanFields":{"type":"object","properties":{"xField":{"type":"string","default":"locXPos"},"yField":{"type":"string","default":"locYPos"},"zField":{"type":"string","nullable":true,"default":null},"zDefaultCm":{"type":"number","default":100},"zoneField":{"type":"string","nullable":true,"default":null},"handlingUnitField":{"type":"string","default":"handlingUnitId"},"shipmentField":{"type":"string","nullable":true,"default":null}},"nullable":true},"captureConfig":{"type":"object","properties":{"pollIntervalSeconds":{"type":"number","default":2},"toleranceSeconds":{"type":"number","default":2},"scanLookbackSeconds":{"type":"number","default":300},"localFrameTtlHours":{"type":"number","default":48},"bufferHardMaxSeconds":{"type":"number","default":600},"bufferFps":{"type":"number","default":30},"fovMarginSide":{"type":"number","default":0.05},"fovMarginTop":{"type":"number","default":0.2}},"nullable":true},"scandropConfig":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"directory":{"type":"string"},"processedDirectory":{"type":"string"}},"nullable":true}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"siteId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"siteId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/cameras":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"externalId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"cameraType":{"type":"string","enum":["rtsp","http_snapshot","other"]},"vendor":{"type":"string"},"model":{"type":"string"},"zones":{"type":"array","items":{"type":"string","minLength":1}},"metadata":{"type":"object","additionalProperties":{}},"intrinsics":{"type":"object","properties":{"fx":{"type":"number"},"fy":{"type":"number"},"cx":{"type":"number"},"cy":{"type":"number"},"k1":{"type":"number","default":0},"k2":{"type":"number","default":0},"p1":{"type":"number","default":0},"p2":{"type":"number","default":0},"k3":{"type":"number","default":0},"imageWidth":{"type":"integer"},"imageHeight":{"type":"integer"}},"required":["fx","fy","cx","cy","imageWidth","imageHeight"],"nullable":true},"intrinsicsUndistorted":{"type":"object","properties":{"fx":{"type":"number"},"fy":{"type":"number"},"cx":{"type":"number"},"cy":{"type":"number"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["fx","fy","cx","cy","width","height"],"nullable":true},"extrinsics":{"type":"object","properties":{"rvec":{},"tvec":{}},"required":["rvec","tvec"],"nullable":true},"measurementConfig":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{}},"nullable":true},"dewarpingMode":{"type":"string","enum":["fixed_views","dynamic_aimed"]},"config":{"type":"object","properties":{"url":{"type":"string","minLength":1},"username":{"type":"string","nullable":true},"password":{"type":"string","nullable":true},"bufferSeconds":{"type":"number","nullable":true},"httpPollIntervalSeconds":{"type":"number","nullable":true},"networkOffsetMs":{"oneOf":[{"type":"integer"},{"enum":["auto"]}],"nullable":true},"zones":{"type":"array","items":{"type":"string","minLength":1},"nullable":true},"rtspTimestampSource":{"type":"string","enum":["wall_clock","rtcp_ntp","camera_metadata"],"nullable":true},"encodingOffsetMs":{"type":"integer","nullable":true},"cameraMetadataUrl":{"type":"string","nullable":true},"onvifDeviceServiceUrl":{"type":"string","nullable":true},"scanArea":{"type":"object","additionalProperties":{},"nullable":true}},"required":["url"]}},"required":["customerId","siteId","name","cameraType"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/cameras/{cameraId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"cameraId","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"cameraType":{"type":"string","enum":["rtsp","http_snapshot","other"]},"status":{"type":"string","enum":["active","inactive","retired"]},"vendor":{"type":"string"},"model":{"type":"string"},"zones":{"type":"array","items":{"type":"string","minLength":1},"nullable":true},"metadata":{"type":"object","additionalProperties":{}},"intrinsics":{"type":"object","properties":{"fx":{"type":"number"},"fy":{"type":"number"},"cx":{"type":"number"},"cy":{"type":"number"},"k1":{"type":"number","default":0},"k2":{"type":"number","default":0},"p1":{"type":"number","default":0},"p2":{"type":"number","default":0},"k3":{"type":"number","default":0},"imageWidth":{"type":"integer"},"imageHeight":{"type":"integer"}},"required":["fx","fy","cx","cy","imageWidth","imageHeight"],"nullable":true},"intrinsicsUndistorted":{"type":"object","properties":{"fx":{"type":"number"},"fy":{"type":"number"},"cx":{"type":"number"},"cy":{"type":"number"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["fx","fy","cx","cy","width","height"],"nullable":true},"extrinsics":{"type":"object","properties":{"rvec":{},"tvec":{}},"required":["rvec","tvec"],"nullable":true},"measurementConfig":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{}},"nullable":true},"dewarpingMode":{"type":"string","enum":["fixed_views","dynamic_aimed"]},"config":{"type":"object","properties":{"url":{"type":"string","minLength":1},"username":{"type":"string","nullable":true},"password":{"type":"string","nullable":true},"bufferSeconds":{"type":"number","nullable":true},"httpPollIntervalSeconds":{"type":"number","nullable":true},"networkOffsetMs":{"oneOf":[{"type":"integer"},{"enum":["auto"]}],"nullable":true},"zones":{"type":"array","items":{"type":"string","minLength":1},"nullable":true},"rtspTimestampSource":{"type":"string","enum":["wall_clock","rtcp_ntp","camera_metadata"],"nullable":true},"encodingOffsetMs":{"type":"integer","nullable":true},"cameraMetadataUrl":{"type":"string","nullable":true},"onvifDeviceServiceUrl":{"type":"string","nullable":true},"scanArea":{"type":"object","additionalProperties":{},"nullable":true}},"nullable":true}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"cameraId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"cameraId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/media-assets":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"cameraId":{"type":"string","format":"uuid"},"externalId":{"type":"string"},"kind":{"type":"string","enum":["snapshot","clip","recording"]},"storage":{"type":"object","properties":{"provider":{"type":"string","enum":["azure_blob","gcs","localfs"]},"account":{"type":"string","minLength":1},"container":{"type":"string","minLength":1},"path":{"type":"string","minLength":1},"signedUrl":{"type":"string","format":"uri"},"signedUrlExpiresAt":{"type":"string","format":"date-time"}},"required":["account","container","path"]},"capturedAtStart":{"type":"string","format":"date-time"},"capturedAtEnd":{"type":"string","format":"date-time"},"mimeType":{"type":"string"},"checksumSha256":{"type":"string"},"sizeBytes":{"type":"integer"},"durationMs":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"},"handlingUnitId":{"type":"string"},"shipmentId":{"type":"string"},"sourceScanId":{"type":"string"},"sourceScanTimestamp":{"type":"string","format":"date-time"},"sourceMetadata":{"type":"object","additionalProperties":{}}},"required":["customerId","siteId","cameraId","kind","storage","capturedAtStart","handlingUnitId"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cameraId","required":false},{"schema":{"type":"string"},"in":"query","name":"handlingUnitId","required":false},{"schema":{"type":"string"},"in":"query","name":"shipmentId","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/media-assets/{mediaAssetId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"mediaAssetId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ingestor/bootstrap":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"string","minLength":1},"in":"query","name":"siteExternalId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ingestor/captures":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"siteId":{"type":"string","format":"uuid"},"cameraId":{"type":"string","format":"uuid"},"frameRequestId":{"type":"string","minLength":1},"customerScanId":{"type":"string","minLength":1},"scanTimestampUtc":{"type":"string"},"captureTimestampUtc":{"type":"string"},"mimeType":{"type":"string","minLength":1},"handlingUnitId":{"type":"string","minLength":1},"shipmentId":{"type":"string","minLength":1},"scanMetadata":{"type":"object","additionalProperties":{}},"ingestorMetadata":{"type":"object","properties":{"cameraType":{"type":"string","minLength":1},"timeOffsetMs":{"type":"integer"},"toleranceSeconds":{"type":"number"},"captureLatencyMs":{"type":"integer"},"targetTimestampUtc":{"type":"string"},"captureTimestampSource":{"type":"string","minLength":1},"rawBlobPath":{"type":"string","minLength":1}},"required":["cameraType"]}},"required":["siteId","cameraId","frameRequestId","customerScanId","scanTimestampUtc","captureTimestampUtc","mimeType","handlingUnitId","scanMetadata","ingestorMetadata"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/ingestor/captures/{id}/upload-complete":{"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sizeBytes":{"type":"integer"},"checksumSha256":{"type":"string","minLength":1},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ingestor/scans":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"siteId":{"type":"string","format":"uuid"},"customerScanId":{"type":"string","minLength":1},"scanTimestampUtc":{"type":"string"},"handlingUnitId":{"type":"string","minLength":1},"shipmentId":{"type":"string","minLength":1},"scanMetadata":{"type":"object","additionalProperties":{}},"captures":{"type":"array","items":{"type":"object","properties":{"cameraId":{"type":"string","format":"uuid"},"frameRequestId":{"type":"string","minLength":1},"captureTimestampUtc":{"type":"string"},"mimeType":{"type":"string","minLength":1},"ingestorMetadata":{"type":"object","properties":{"cameraType":{"type":"string","minLength":1},"timeOffsetMs":{"type":"integer"},"toleranceSeconds":{"type":"number"},"captureLatencyMs":{"type":"integer"},"targetTimestampUtc":{"type":"string"},"captureTimestampSource":{"type":"string","minLength":1},"rawBlobPath":{"type":"string","minLength":1}},"required":["cameraType"]}},"required":["cameraId","frameRequestId","captureTimestampUtc","mimeType","ingestorMetadata"]}}},"required":["siteId","customerScanId","scanTimestampUtc","handlingUnitId","scanMetadata","captures"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/processing-jobs":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"jobType":{"type":"string","enum":["measurement","ai_inference"]},"workflowKey":{"type":"string","minLength":1},"idempotencyKey":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"inputAssets":{"type":"array","items":{"type":"object","properties":{"mediaAssetId":{"type":"string","format":"uuid"},"inputRole":{"type":"string","enum":["primary","secondary"],"default":"primary"},"sortOrder":{"type":"integer","default":0}},"required":["mediaAssetId"]}}},"required":["customerId","jobType","workflowKey","inputAssets"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"workflowKey","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/processing-jobs/{jobId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"jobId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/internal/jobs/{jobId}/run":{"post":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"jobId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-results":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string"},"in":"query","name":"handlingUnit","required":false},{"schema":{"type":"string"},"in":"query","name":"shipmentId","required":false},{"schema":{"type":"string","enum":["measurement_v1","object_detection_v1"]},"in":"query","name":"resultType","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"includeUnreviewed","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-results/{resultId}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"resultId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/handling-units/{handlingUnit}/latest-result":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","minLength":1},"in":"path","name":"handlingUnit","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/ai-results/{resultId}/artifacts/{artifactKind}/url":{"post":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"resultId","required":true},{"schema":{"type":"string","enum":["image","modelPly"]},"in":"path","name":"artifactKind","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/artifacts/local/{resultId}/{artifactKind}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"resultId","required":true},{"schema":{"type":"string","enum":["image","modelPly"]},"in":"path","name":"artifactKind","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/scans":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"capturedAt":{"type":"string","format":"date-time"},"handlingUnitId":{"type":"string","minLength":1},"shipmentId":{"type":"string","minLength":1},"identifiers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["customer_scan_id","handling_unit_id","shipment_id","frame_request_id"]},"value":{"type":"string","minLength":1}},"required":["type","value"]}},"metadata":{"type":"object","additionalProperties":{}}},"required":["customerId","siteId","capturedAt","identifiers"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"string","enum":["ingestion","dewarping","classification","measurement","qa"]},"in":"query","name":"stage","required":false},{"schema":{"type":"string","enum":["pending","running","succeeded","failed","skipped","rejected"]},"in":"query","name":"stageStatus","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false},{"schema":{"type":"integer","minimum":1,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/scans/stats":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/scans/{id}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/scans/{id}/stages/{stage}/start":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operator":{"type":"string","minLength":1},"inputRef":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","enum":["ingestion","dewarping","classification","measurement","qa"]},"in":"path","name":"stage","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/scans/{id}/stages/{stage}/complete":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["succeeded","failed","skipped","rejected"]},"outputRef":{"type":"object","additionalProperties":{}},"providerPayload":{"type":"object","additionalProperties":{}},"error":{"type":"string"}},"required":["status"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","enum":["ingestion","dewarping","classification","measurement","qa"]},"in":"path","name":"stage","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/koch-pending-measurement-qa-handling-units":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/koch-reference-sync/request":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/reference-measurements":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"matchedBy":{"type":"string","enum":["customer_scan_id","handling_unit_id","shipment_id","frame_request_id"]},"matchedValue":{"type":"string","minLength":1},"lengthCm":{"type":"integer"},"widthCm":{"type":"integer"},"heightCm":{"type":"integer"},"sourceSystem":{"type":"string","minLength":1},"sourceRecordId":{"type":"string","minLength":1},"importBatchId":{"type":"string","minLength":1}},"required":["customerId","matchedBy","matchedValue","lengthCm","widthCm","heightCm","sourceSystem"]}}}},"responses":{"200":{"description":"Default Response"}}},"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"scanId","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/import-reference-measurements":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"sourceSystem":{"type":"string","minLength":1},"importBatchId":{"type":"string","minLength":1},"measurements":{"type":"array","items":{"type":"object","properties":{"matchedBy":{"type":"string","enum":["customer_scan_id","handling_unit_id","shipment_id","frame_request_id"]},"matchedValue":{"type":"string","minLength":1},"lengthCm":{"type":"integer"},"widthCm":{"type":"integer"},"heightCm":{"type":"integer"},"sourceRecordId":{"type":"string","minLength":1}},"required":["matchedBy","matchedValue","lengthCm","widthCm","heightCm"]}}},"required":["customerId","sourceSystem","measurements"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/reference-measurements/{id}":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/process-classification":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/classification-result":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","minLength":1},"status":{"type":"string","enum":["completed","failed"]},"result":{"type":"object","properties":{"scanner_present":{"type":"boolean"},"is_measurable":{"type":"boolean","nullable":true},"confidence":{"type":"number","nullable":true},"gap":{"type":"number","nullable":true},"best_frame":{"type":"string","nullable":true},"review_flags":{"type":"array","items":{"type":"string"},"nullable":true},"signals":{"type":"object","additionalProperties":{},"nullable":true},"segmentation":{"nullable":true}},"required":["scanner_present","confidence","gap"]},"error":{"type":"string"}},"required":["job_id","status"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/classification-recover-polled":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sinceHours":{"type":"integer","default":48},"limit":{"type":"integer","default":500},"dryRun":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/classification-reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"scanIds":{"type":"array","items":{"type":"string","format":"uuid"}},"since":{"type":"string","format":"date-time"},"reason":{"type":"string","default":"manual classification reset"}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/process-dewarping":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/dewarping-reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"scanIds":{"type":"array","items":{"type":"string","format":"uuid"}},"reason":{"type":"string","default":"manual dewarping reset"}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/dewarping-reject-stuck":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scanIds":{"type":"array","items":{"type":"string","format":"uuid"}},"reason":{"type":"string","default":"manual reject-stuck (TECH-163 cleanup)"}},"required":["scanIds"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/pending":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cameraId","required":false},{"schema":{"type":"number","default":0},"in":"query","name":"minGap","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"excludeOverlapSeconds","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"hideNoScanner","required":false},{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"default":[]},"in":"query","name":"excludedCustomerIds","required":false},{"schema":{"type":"string","enum":["oldest","newest"],"default":"oldest"},"in":"query","name":"sortOrder","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/summary":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cameraId","required":false},{"schema":{"type":"number","default":0},"in":"query","name":"minGap","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"excludeOverlapSeconds","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"hideNoScanner","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/{scanId}/review":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"decision":{"enum":["accepted"]},"kochScaleFactor":{"type":"object","properties":{"objective":{"type":"string","enum":["t30_mae","per_dim_5cm_count"]}},"required":["objective"]}},"required":["decision"]},{"type":"object","properties":{"decision":{"enum":["rejected"]},"reason":{"type":"string","enum":["ambiguous","bad_segmentation","item_not_measurable","mixed_pallet","no_scan_visible","wrong_item_selected","bad_bounding_box_fit","bad_measurements","other","barcode_not_attached","stacked_items"]},"correction":{"type":"object","properties":{"lengthCm":{"type":"integer"},"widthCm":{"type":"integer"},"heightCm":{"type":"integer"},"obbCornersPx":{"type":"array","items":{"type":"object","properties":{"u":{"type":"number"},"v":{"type":"number"}},"required":["u","v"]}}},"required":["lengthCm","widthCm","heightCm","obbCornersPx"]}},"required":["decision"]}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/{scanId}/review/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stageRunId":{"type":"string","format":"uuid"}},"required":["stageRunId"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/reviews/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object","properties":{"scanId":{"type":"string","format":"uuid"},"stageRunId":{"type":"string","format":"uuid"}},"required":["scanId","stageRunId"]}}},"required":["reviews"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-classification/stats":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/leaderboard":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/leaderboard/daily":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":7},"in":"query","name":"days","required":false},{"schema":{"type":"string"},"in":"query","name":"tz","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/summary":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cameraId","required":false},{"schema":{"type":"number","default":0},"in":"query","name":"minGap","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"excludeOverlapSeconds","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"hideNoScanner","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/review":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"decision":{"enum":["accepted"]},"kochScaleFactor":{"type":"object","properties":{"objective":{"type":"string","enum":["t30_mae","per_dim_5cm_count"]}},"required":["objective"]}},"required":["decision"]},{"type":"object","properties":{"decision":{"enum":["rejected"]},"reason":{"type":"string","enum":["ambiguous","bad_segmentation","item_not_measurable","mixed_pallet","no_scan_visible","wrong_item_selected","bad_bounding_box_fit","bad_measurements","other","barcode_not_attached","stacked_items"]},"correction":{"type":"object","properties":{"lengthCm":{"type":"integer"},"widthCm":{"type":"integer"},"heightCm":{"type":"integer"},"obbCornersPx":{"type":"array","items":{"type":"object","properties":{"u":{"type":"number"},"v":{"type":"number"}},"required":["u","v"]}}},"required":["lengthCm","widthCm","heightCm","obbCornersPx"]}},"required":["decision"]}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/review/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stageRunId":{"type":"string","format":"uuid"}},"required":["stageRunId"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/reviews/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object","properties":{"scanId":{"type":"string","format":"uuid"},"stageRunId":{"type":"string","format":"uuid"}},"required":["scanId","stageRunId"]}}},"required":["reviews"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/stats":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/pending":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMinMaeCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxMaeCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxLengthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxWidthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxHeightDeviationCm","required":false},{"schema":{"type":"boolean"},"in":"query","name":"kochApplyScaleFactor","required":false},{"schema":{"type":"string","enum":["t30_mae","per_dim_5cm_count"],"default":"t30_mae"},"in":"query","name":"kochScaleFactorObjective","required":false},{"schema":{"type":"boolean"},"in":"query","name":"kochMissingGroundTruth","required":false},{"schema":{"type":"string"},"in":"query","name":"cameraViews","required":false},{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"default":[]},"in":"query","name":"excludedCustomerIds","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false},{"schema":{"type":"number","default":0},"in":"query","name":"minGap","required":false},{"schema":{"type":"string","enum":["oldest","newest","value"],"default":"oldest"},"in":"query","name":"sortOrder","required":false},{"schema":{"type":"string","enum":["sa","se","unknown"]},"in":"query","name":"eberlDirection","required":false},{"schema":{"type":"string","enum":["eigenkunde","beschaffer","unknown"]},"in":"query","name":"eberlCustomerType","required":false},{"schema":{"type":"boolean"},"in":"query","name":"includeNoScanner","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/build-from-scratch":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lengthCm":{"type":"integer"},"widthCm":{"type":"integer"},"heightCm":{"type":"integer"},"obbCornersPx":{"type":"array","items":{"type":"object","properties":{"u":{"type":"number"},"v":{"type":"number"}},"required":["u","v"]}}},"required":["lengthCm","widthCm","heightCm","obbCornersPx"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/build-from-scratch/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/no-scanner-reject":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/no-scanner-reject/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/frames":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/{scanId}/overlay":{"get":{"parameters":[{"schema":{"type":"string"},"in":"query","name":"expires","required":true},{"schema":{"type":"string"},"in":"query","name":"sig","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/camera-views":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"default":[]},"in":"query","name":"excludedCustomerIds","required":false},{"schema":{"type":"boolean"},"in":"query","name":"includeNoScanner","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/koch-auto-review-by-filter":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kochMaxMaeCm":{"type":"number"},"kochMaxLengthDeviationCm":{"type":"number"},"kochMaxWidthDeviationCm":{"type":"number"},"kochMaxHeightDeviationCm":{"type":"number"},"kochApplyScaleFactor":{"type":"boolean"},"kochScaleFactorObjective":{"type":"string","enum":["t30_mae","per_dim_5cm_count"],"default":"t30_mae"}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/koch-auto-scale":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kochScaleFactorObjective":{"type":"string","enum":["t30_mae","per_dim_5cm_count"],"default":"t30_mae"}},"default":{"kochScaleFactorObjective":"t30_mae"}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/measurement-ready-scans":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string"},"in":"query","name":"scanIds","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/measurement-reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"scanIds":{"type":"array","items":{"type":"string","format":"uuid"}},"reason":{"type":"string","default":"manual reset"}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/measurement-results":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scanId":{"type":"string","format":"uuid"},"handlingUnits":{"type":"array","items":{"type":"object","properties":{"handlingUnitId":{"type":"string","minLength":1},"lengthCm":{"type":"number"},"widthCm":{"type":"number"},"heightCm":{"type":"number"},"artifacts":{"type":"object","additionalProperties":{},"default":{}},"resultPayload":{"type":"object","additionalProperties":{},"default":{}}},"required":["lengthCm","widthCm","heightCm"]}}},"required":["scanId","handlingUnits"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/pending":{"get":{"parameters":[{"schema":{"type":"integer","minimum":1,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","default":0},"in":"query","name":"offset","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMinMaeCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxMaeCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxLengthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxWidthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxHeightDeviationCm","required":false},{"schema":{"type":"boolean"},"in":"query","name":"kochApplyScaleFactor","required":false},{"schema":{"type":"string","enum":["t30_mae","per_dim_5cm_count"],"default":"t30_mae"},"in":"query","name":"kochScaleFactorObjective","required":false},{"schema":{"type":"boolean"},"in":"query","name":"kochMissingGroundTruth","required":false},{"schema":{"type":"string"},"in":"query","name":"cameraViews","required":false},{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"default":[]},"in":"query","name":"excludedCustomerIds","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedAfter","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"capturedBefore","required":false},{"schema":{"type":"number","default":0},"in":"query","name":"minGap","required":false},{"schema":{"type":"string","enum":["oldest","newest","value"],"default":"oldest"},"in":"query","name":"sortOrder","required":false},{"schema":{"type":"string","enum":["sa","se","unknown"]},"in":"query","name":"eberlDirection","required":false},{"schema":{"type":"string","enum":["eigenkunde","beschaffer","unknown"]},"in":"query","name":"eberlCustomerType","required":false},{"schema":{"type":"boolean"},"in":"query","name":"includeNoScanner","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/summary":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/{scanId}/frames":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/{scanId}/review":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"decision":{"enum":["accepted"]}},"required":["decision"]},{"type":"object","properties":{"decision":{"enum":["rejected"]},"reason":{"type":"string","enum":["bad_bounding_box_fit","bad_measurements","bad_classification","other"]}},"required":["decision"]}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/{scanId}/review/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stageRunId":{"type":"string","format":"uuid"}},"required":["stageRunId"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/reviews/reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object","properties":{"scanId":{"type":"string","format":"uuid"},"stageRunId":{"type":"string","format":"uuid"}},"required":["scanId","stageRunId"]}}},"required":["reviews"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/bulk-review":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object","properties":{"scanId":{"type":"string","format":"uuid"},"decision":{"type":"string","enum":["accepted","rejected"]},"reason":{"type":"string","enum":["bad_bounding_box_fit","bad_measurements","bad_classification","other"]}},"required":["scanId","decision"]}}},"required":["reviews"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/stats":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false},{"schema":{"type":"boolean"},"in":"query","name":"includeKochDetails","required":false},{"schema":{"type":"number"},"in":"query","name":"kochDeviationThresholdCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxMaeCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxLengthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxWidthDeviationCm","required":false},{"schema":{"type":"number"},"in":"query","name":"kochMaxHeightDeviationCm","required":false},{"schema":{"type":"boolean"},"in":"query","name":"kochApplyScaleFactor","required":false},{"schema":{"type":"string","enum":["t30_mae","per_dim_5cm_count"],"default":"t30_mae"},"in":"query","name":"kochScaleFactorObjective","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/qa-measurement/{scanId}/overlay":{"get":{"parameters":[{"schema":{"type":"string"},"in":"query","name":"expires","required":true},{"schema":{"type":"string"},"in":"query","name":"sig","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"scanId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/exports/measurements":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false},{"schema":{"type":"string","enum":["csv"],"default":"csv"},"in":"query","name":"format","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/reviewed-scan-images":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true},{"schema":{"type":"integer","minimum":1,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/process-privacy-blur":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","default":25},"withinDays":{"type":"integer","default":14},"scanIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"default":{"limit":25,"withinDays":14}}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/internal/process-measurement":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/measurement/results":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string","minLength":1},"status":{"type":"string","enum":["success","error"]},"measurements":{"type":"array","items":{"type":"object","properties":{"image_name":{"type":"string"},"camera":{"type":"string"},"length_cm":{"type":"number"},"width_cm":{"type":"number"},"height_cm":{"type":"number"}},"required":["image_name","camera","length_cm","width_cm","height_cm"]},"default":[]},"expected_scans":{"type":"integer","nullable":true,"default":0},"output_uris":{"type":"object","properties":{"measurements_csv":{"type":"string","nullable":true},"ply_files":{"type":"array","items":{"type":"string"}},"ply_downsampled_files":{"type":"array","items":{"type":"string"}},"obb_projection_json_files":{"type":"array","items":{"type":"string"}}}},"error":{"type":"string","nullable":true},"error_type":{"type":"string","enum":["inference_oom","inference_failed","mask_missing","image_download_failed","config_invalid","upload_failed"],"nullable":true}},"required":["run_id","status"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/auth/request-link":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/auth/verify":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":10},"otp":{"type":"string"}},"required":["token"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/auth/select-customer":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"}},"required":["customerId"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/auth/logout":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/auth/session":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/auth/request-link":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/auth/verify":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":10}},"required":["token"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/auth/logout":{"post":{"responses":{"200":{"description":"Default Response"}}}},"/v1/qa/auth/session":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/data/handling-units":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/data/zobel-tariff-flags":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/data/handling-units/export":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/data/shipments/{shipmentId}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"shipmentId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/customer/data/handling-units/{handlingUnitId}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"handlingUnitId","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"handlingUnitId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/overview":{"get":{"parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/gates":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/pause":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stage":{"type":"string","enum":["dewarping","classification","measurement"]},"reason":{"type":"string"}},"required":["stage"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/resume":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stage":{"type":"string","enum":["dewarping","classification","measurement"]}},"required":["stage"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/customer-gates":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/effective-gates":{"get":{"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"customerId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/customer-pause":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"stage":{"type":"string","enum":["dewarping","classification","measurement"]},"reason":{"type":"string"}},"required":["customerId","stage"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/customer-resume":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"stage":{"type":"string","enum":["dewarping","classification","measurement"]}},"required":["customerId","stage"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/pipeline/customer-reset":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"customerId":{"type":"string","format":"uuid"},"stage":{"type":"string","enum":["dewarping","classification","measurement"]},"reason":{"type":"string","default":"manual customer stage reset"}},"required":["customerId","stage"]}}}},"responses":{"200":{"description":"Default Response"}}}},"/admin":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/resources/{resourceId}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/search/{query}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"query","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/resources/{resourceId}/actions/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/actions/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/actions/{action}/{query}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true},{"schema":{"type":"string"},"in":"path","name":"query","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/resources/{resourceId}/records/{recordId}/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"recordId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/records/{recordId}/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"recordId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"recordId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/resources/{resourceId}/bulk/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/bulk/{action}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true},{"schema":{"type":"string"},"in":"path","name":"action","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/resources/{resourceId}/search":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"resourceId","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/dashboard":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/pages/{pageName}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"pageName","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/api/pages/{pageName}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"pageName","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"pageName","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/icomoon.css":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/icomoon.eot":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/icomoon.svg":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/icomoon.ttf":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/icomoon.woff":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/app.bundle.js":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/global.bundle.js":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/design-system.bundle.js":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/logo.svg":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/logo-mini.svg":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/frontend/assets/components.bundle.js":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/admin/login":{"get":{"responses":{"200":{"description":"Default Response"}}},"post":{"responses":{"200":{"description":"Default Response"}}}},"/admin/logout":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/refresh-token":{"post":{"responses":{"200":{"description":"Default Response"}}}}},"security":[{"bearerAuth":[]}]}