{ "components": { "headers": { "Deprecation": { "description": "Legacy route deprecation activation. Production returns an RFC 9745 date value; unconfigured local environments return true.", "example": "@1784152800", "schema": { "type": "string" } }, "MigrationLink": { "description": "Customer migration guide using the deprecation link relation.", "example": "\u003chttps://docs.lsmc.life/customer-api/how-to/migrate-api-routes/\u003e; rel=\"deprecation\"; type=\"text/html\"", "schema": { "type": "string" } }, "Sunset": { "description": "Planned legacy route retirement date, 90 days after activation, formatted as an HTTP-date.", "example": "Tue, 13 Oct 2026 22:00:00 GMT", "schema": { "type": "string" } } }, "parameters": { "ArtifactID": { "in": "path", "name": "artifact_euid", "required": true, "schema": { "type": "string" } }, "CustomerCaseID": { "in": "query", "name": "customer_case_id", "schema": { "type": "string" } }, "CustomerOrderID": { "description": "Partner/customer order identifier. This is not LabCore internal orders.id, a BioTouch order number, or a Meridian order_euid/TRF EUID.", "in": "query", "name": "customer_order_id", "schema": { "type": "string" } }, "CustomerPatientID": { "in": "query", "name": "customer_patient_id", "schema": { "type": "string" } }, "EffectiveSampleHoldType": { "description": "Repeat to match the highest-priority effective hold type.", "explode": true, "in": "query", "name": "effective_hold_type", "schema": { "items": { "enum": [ "REDRAW_REQUIRED", "ORDER_RECONCILIATION_REQUIRED", "CUSTOMER_HOLD", "METADATA_RECONCILIATION_REQUIRED", "MISSING_REQUIRED_METADATA" ], "type": "string" }, "type": "array" }, "style": "form" }, "ID": { "description": "Internal resource ID. Order routes also accept the order_euid.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, "IdempotencyKey": { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "maxLength": 255, "type": "string" } }, "LabCoreContainerEUID": { "in": "query", "name": "labcore_container_euid", "schema": { "type": "string" } }, "LabCoreSpecimenEUID": { "in": "query", "name": "labcore_specimen_euid", "schema": { "type": "string" } }, "OrderEUID": { "in": "query", "name": "order_euid", "schema": { "type": "string" } }, "OrderTestEUID": { "in": "query", "name": "order_test_euid", "schema": { "type": "string" } }, "RequestID": { "in": "header", "name": "X-Request-ID", "required": false, "schema": { "type": "string" } }, "SampleEUIDQuery": { "in": "query", "name": "sample_euid", "schema": { "type": "string" } }, "SampleHoldCursor": { "description": "Opaque continuation cursor bound to the authenticated partner and exact filters.", "in": "query", "name": "cursor", "schema": { "type": "string" } }, "SampleHoldLimit": { "in": "query", "name": "limit", "schema": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" } }, "SampleHoldPoint": { "description": "Repeat to match any hold at one of the requested workflow boundaries.", "explode": true, "in": "query", "name": "hold_point", "schema": { "items": { "enum": [ "pre_accession", "pre_processing", "pre_analysis", "pre_results", "redraw_required", "customer_hold" ], "type": "string" }, "type": "array" }, "style": "form" }, "SampleHoldRaisedAfter": { "in": "query", "name": "raised_after", "schema": { "format": "date-time", "type": "string" } }, "SampleHoldRaisedBefore": { "in": "query", "name": "raised_before", "schema": { "format": "date-time", "type": "string" } }, "SampleHoldRequiredAction": { "explode": true, "in": "query", "name": "required_action", "schema": { "items": { "enum": [ "reconcile_order", "correct_data", "release_customer_hold", "replace_specimen" ], "type": "string" }, "type": "array" }, "style": "form" }, "SampleHoldSort": { "in": "query", "name": "sort", "schema": { "default": "priority", "enum": [ "priority", "raised_at" ], "type": "string" } }, "SampleHoldStatus": { "description": "Repeat to match a sample's current partner-facing status.", "explode": true, "in": "query", "name": "status", "schema": { "items": { "enum": [ "IN_PROGRESS", "PROCESSING_HELD", "ANALYSIS_HELD", "RESULTS_HELD", "REDRAW_REQUIRED" ], "type": "string" }, "type": "array" }, "style": "form" }, "SampleHoldType": { "description": "Repeat to match any requested active hold type. Informational conditions are not hold types.", "explode": true, "in": "query", "name": "hold_type", "schema": { "items": { "enum": [ "REDRAW_REQUIRED", "ORDER_RECONCILIATION_REQUIRED", "EXTERNAL_HOLD", "CUSTOMER_HOLD", "METADATA_RECONCILIATION_REQUIRED", "MISSING_REQUIRED_METADATA" ], "type": "string" }, "type": "array" }, "style": "form" }, "SampleHoldUpdateAllowed": { "in": "query", "name": "update_allowed", "schema": { "type": "boolean" } }, "ShipmentBarcode": { "in": "query", "name": "shipment_barcode", "schema": { "type": "string" } }, "SpecimenEUIDQuery": { "in": "query", "name": "specimen_euid", "schema": { "type": "string" } }, "TRFEUID": { "in": "query", "name": "trf_euid", "schema": { "type": "string" } }, "TestkitBarcode": { "in": "query", "name": "testkit_barcode", "schema": { "type": "string" } } }, "responses": { "BadRequest": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "BadRequestLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "Conflict": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Idempotency conflict" }, "ConflictLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Idempotency conflict", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "Forbidden": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request origin is not allowed or deterministic test controls are disabled" }, "ForbiddenLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request origin is not allowed or deterministic test controls are disabled", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "InternalServerError": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal server error" }, "InternalServerErrorLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal server error", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "NotFound": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource not found" }, "NotFoundLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource not found", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "Unauthorized": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Missing or invalid bearer token" }, "UnauthorizedLegacy": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Missing or invalid bearer token", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } } }, "schemas": { "Artifact": { "properties": { "artifact_euid": { "type": "string" }, "artifact_type": { "description": "Canonical, case-sensitive file category. Index sidecars remain distinct from their data artifacts: vcf_index identifies a Tabix index paired with a vcf artifact, copy_number_index identifies a Tabix index paired with copy_number_tsv, and cram_index identifies a CRAI index paired with cram.", "enum": [ "accessioning_metadata", "analysis_results", "copy_number_tsv", "copy_number_index", "vcf", "vcf_index", "ploidy_qc", "cram", "cram_index", "qc_report" ], "type": "string" }, "checksum": { "description": "Algorithm-prefixed integrity value. Simulation result fixtures use crc64nvme:\u003cbase64-encoded full-object CRC64NVME\u003e; multipart ETags are not content checksums.", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "filename": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "format": "int64", "type": "integer" }, "source_system": { "type": "string" }, "source_uid": { "type": "string" }, "storage_uri": { "description": "Complete artifact storage URI. Nested object paths such as results/cram/ are preserved.", "type": "string" } }, "type": "object" }, "ArtifactDownloadResponse": { "allOf": [ { "$ref": "#/components/schemas/ArtifactReadResponse" }, { "properties": { "download_url": { "description": "Temporary signed URL for downloading the single API-managed artifact identified by artifact.artifact_euid. In deployed s3_presign mode this is a S3 presigned GET URL for s3:// storage_uri values and a LabCore token URL for other storage schemes.", "format": "uri", "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "expires_in_seconds": { "type": "integer" } }, "type": "object" } ], "description": "A temporary signed download URL for one API-managed artifact record. In deployed s3_presign mode, LabCore returns a S3 presigned GET URL for file-level artifacts with s3:// storage_uri values and an expiring LabCore token URL for other storage schemes." }, "ArtifactListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/ArtifactReadResponse" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" }, "ArtifactReadResponse": { "properties": { "artifact": { "$ref": "#/components/schemas/Artifact" }, "identity_map": { "$ref": "#/components/schemas/IdentityMap" }, "order": { "$ref": "#/components/schemas/OrderResponse" }, "release_packages": { "items": { "type": "object" }, "type": "array" } }, "type": "object" }, "ErrorResponse": { "properties": { "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "ExternalHoldCreateResponse": { "properties": { "hold_euids": { "items": { "type": "string" }, "type": "array" }, "lifecycle_state": { "enum": [ "PRE_CHECK", "ACTIVE", "REJECTED", "CANCELED", "RELEASED", "FAILED" ], "type": "string" }, "order_euid": { "type": "string" }, "request_euid": { "type": "string" }, "sample_euids": { "items": { "type": "string" }, "type": "array" } }, "required": [ "request_euid", "lifecycle_state", "hold_euids", "sample_euids" ], "type": "object" }, "ExternalHoldListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/ExternalHoldResponse" }, "type": "array" } }, "required": [ "items" ], "type": "object" }, "ExternalHoldRequest": { "oneOf": [ { "required": [ "sample_euid" ] }, { "required": [ "order_euid" ] } ], "properties": { "blocked_stage": { "maxLength": 64, "type": "string" }, "metadata": { "additionalProperties": true, "type": "object" }, "order_euid": { "type": "string" }, "reason": { "maxLength": 1024, "type": "string" }, "reason_code": { "maxLength": 128, "type": "string" }, "sample_euid": { "type": "string" } }, "required": [ "reason_code", "reason", "blocked_stage" ], "type": "object" }, "ExternalHoldResponse": { "properties": { "blocked_stage": { "type": "string" }, "hold_euid": { "type": "string" }, "hold_version": { "type": "integer" }, "initiator": { "type": "string" }, "lifecycle_state": { "type": "string" }, "metadata": { "additionalProperties": true, "type": "object" }, "order_euid": { "type": "string" }, "reason": { "type": "string" }, "reason_code": { "type": "string" }, "request_euid": { "type": "string" }, "sample_euid": { "type": "string" } }, "required": [ "request_euid", "lifecycle_state", "hold_euid", "hold_version", "sample_euid", "reason_code", "reason", "blocked_stage", "initiator" ], "type": "object" }, "ExternalHoldTransitionRequest": { "properties": { "hold_version": { "minimum": 1, "type": "integer" }, "reason": { "type": "string" } }, "required": [ "hold_version" ], "type": "object" }, "ExternalRefRequest": { "properties": { "kind": { "type": "string" }, "namespace": { "type": "string" }, "target_hint": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ], "type": "object" }, "IdentityExternalRef": { "properties": { "kind": { "type": "string" }, "namespace": { "type": "string" }, "target_euid": { "type": "string" }, "target_type": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "IdentityMap": { "properties": { "customer_case_id": { "type": "string" }, "customer_order_id": { "type": "string" }, "external_refs": { "items": { "$ref": "#/components/schemas/IdentityExternalRef" }, "type": "array" }, "labcore_lims": { "properties": { "container_euids": { "items": { "type": "string" }, "type": "array" }, "specimen_euids": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "order_euid": { "type": "string" }, "patients": { "items": { "$ref": "#/components/schemas/IdentityPatient" }, "type": "array" } }, "type": "object" }, "IdentityPatient": { "properties": { "accession_euid": { "type": "string" }, "collection_date": { "description": "Order or requisition specimen collection date when provided.", "format": "date", "type": "string" }, "collection_method": { "type": "string" }, "customer_patient_id": { "type": "string" }, "patient_euid": { "type": "string" }, "role": { "type": "string" }, "specimen_barcode": { "type": "string" }, "specimen_euid": { "type": "string" } }, "type": "object" }, "KitOrder": { "properties": { "bio_touch_item_status": { "type": "string" }, "bio_touch_order_number": { "example": "PATH-123", "type": "string" }, "bio_touch_status": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "customer_order_id": { "example": "INF-ORDER-001", "type": "string" }, "deliver_date": { "type": "string" }, "kit_order_euid": { "example": "M-K1T-16", "type": "string" }, "last_error": { "type": "string" }, "last_poll_at": { "format": "date-time", "type": "string" }, "last_submitted_at": { "format": "date-time", "type": "string" }, "metadata": { "additionalProperties": true, "type": "object" }, "next_poll_at": { "format": "date-time", "type": "string" }, "notes": { "type": "string" }, "operator_reference": { "type": "string" }, "outbound_tracking": { "items": { "$ref": "#/components/schemas/KitOrderTracking" }, "type": "array" }, "patient": { "$ref": "#/components/schemas/KitOrderPatient" }, "quantity": { "type": "integer" }, "recipient": { "$ref": "#/components/schemas/KitOrderRecipient" }, "reference": { "example": "M-K1T-16", "type": "string" }, "requested_by": { "type": "string" }, "ship_date": { "type": "string" }, "sku": { "enum": [ "5501", "5504", "5505" ], "type": "string" }, "sku_name": { "type": "string" }, "status": { "enum": [ "submission_pending", "submitted", "submission_failed", "processing", "shipped", "delivered", "canceled", "delivery_exception" ], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "kit_order_euid", "reference", "status", "sku", "sku_name", "quantity", "recipient", "created_at", "updated_at" ], "type": "object" }, "KitOrderCreateRequest": { "properties": { "customer_order_id": { "description": "Optional INFL-owned external order identifier. When supplied on partner kit-order creation, LabCore resolves it through the inflection external identifier binding and links the kit order to the matching clinical order. This is not LabCore internal orders.id, a BioTouch order number, or a Meridian order_euid/TRF EUID. Do not send order_id as an alias.", "example": "INF-ORDER-001", "type": "string" }, "metadata": { "additionalProperties": true, "type": "object" }, "notes": { "type": "string" }, "operator_reference": { "type": "string" }, "patient": { "$ref": "#/components/schemas/KitOrderPatientRequest" }, "quantity": { "minimum": 1, "type": "integer" }, "recipient": { "$ref": "#/components/schemas/KitOrderRecipientRequest" }, "sku": { "enum": [ "5501", "5504", "5505" ], "type": "string" } }, "required": [ "sku", "quantity", "recipient" ], "type": "object" }, "KitOrderCreateResponse": { "properties": { "idempotent_replay": { "type": "boolean" }, "kit_order": { "$ref": "#/components/schemas/KitOrder" }, "request_id": { "type": "string" } }, "required": [ "request_id", "idempotent_replay", "kit_order" ], "type": "object" }, "KitOrderListResponse": { "properties": { "kit_orders": { "items": { "$ref": "#/components/schemas/KitOrder" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "kit_orders", "total" ], "type": "object" }, "KitOrderPatient": { "properties": { "patient_dob": { "example": "2006-01-02", "format": "date", "type": "string" }, "patient_id": { "example": "CUSTP001", "type": "string" }, "patient_name": { "example": "Jane Patient", "type": "string" } }, "required": [ "patient_name", "patient_id", "patient_dob" ], "type": "object" }, "KitOrderPatientRequest": { "properties": { "patient_dob": { "example": "2006-01-02", "format": "date", "type": "string" }, "patient_id": { "example": "CUSTP001", "type": "string" }, "patient_name": { "example": "Jane Patient", "type": "string" } }, "required": [ "patient_name", "patient_id", "patient_dob" ], "type": "object" }, "KitOrderReadResponse": { "properties": { "kit_order": { "$ref": "#/components/schemas/KitOrder" } }, "required": [ "kit_order" ], "type": "object" }, "KitOrderRecipient": { "properties": { "address1": { "example": "123 Main St", "type": "string" }, "address2": { "type": "string" }, "city": { "example": "Atlanta", "type": "string" }, "country": { "example": "US", "type": "string" }, "phone": { "example": "555-0100", "type": "string" }, "ship_to": { "example": "Jane Patient", "type": "string" }, "state": { "example": "GA", "type": "string" }, "zip": { "example": "30301", "type": "string" } }, "required": [ "ship_to", "address1", "city", "state", "zip", "country" ], "type": "object" }, "KitOrderRecipientRequest": { "properties": { "address1": { "example": "123 Main St", "type": "string" }, "address2": { "type": "string" }, "city": { "example": "Atlanta", "type": "string" }, "country": { "example": "US", "type": "string" }, "phone": { "example": "555-0100", "type": "string" }, "ship_to": { "example": "Jane Patient", "type": "string" }, "state": { "example": "GA", "type": "string" }, "zip": { "example": "30301", "type": "string" } }, "required": [ "ship_to", "address1", "city", "state", "zip", "country" ], "type": "object" }, "KitOrderTracking": { "properties": { "accession_number": { "type": "string" }, "expiration_date": { "type": "string" }, "kit_lot_number": { "type": "string" }, "ship_date": { "type": "string" }, "ship_method": { "type": "string" }, "ship_service": { "example": "UPS 2nd Day Air", "type": "string" }, "status": { "example": "In Transit", "type": "string" }, "tracking_number": { "example": "1Z999", "type": "string" } }, "type": "object" }, "OrderCancellationRequest": { "example": { "reason": "provider_requested", "requested_by": "inflection-api" }, "properties": { "metadata": { "additionalProperties": true, "type": "object" }, "reason": { "type": "string" }, "requested_by": { "type": "string" } }, "required": [ "reason", "requested_by" ], "type": "object" }, "OrderCancellationResponse": { "properties": { "accepted": { "type": "boolean" }, "event_id": { "type": "string" }, "idempotent_replay": { "type": "boolean" }, "order_euid": { "type": "string" }, "request_id": { "type": "string" }, "status": { "type": "string" } }, "required": [ "accepted", "idempotent_replay", "request_id", "order_euid", "status", "event_id" ], "type": "object" }, "OrderCreateIdentityMap": { "properties": { "customer_case_id": { "type": "string" }, "customer_order_id": { "type": "string" }, "external_refs": { "items": { "$ref": "#/components/schemas/IdentityExternalRef" }, "type": "array" }, "patients": { "items": { "$ref": "#/components/schemas/IdentityPatient" }, "type": "array" } }, "type": "object" }, "OrderCreateRequest": { "example": { "customer_case_id": "CASE-1001", "customer_order_id": "INFL-1001", "external_refs": [ { "kind": "shipment_barcode", "namespace": "inflection", "target_hint": "order", "value": "SHIP-001" } ], "metadata": { "simulation_result_sample": "HG007", "workflow_seed": "seed-001" }, "order_tests": [ { "customer_test_id": "TEST-001", "fulfillment_routes": [ { "fulfillment_route_code": "WGS" } ], "priority": "NORMAL", "specimen_type": "blood" } ], "order_type": "CLINICAL", "patients": [ { "collection_method": "home_buccal_kit", "customer_patient_id": "INF-PT-001", "demographics": { "date_of_birth": "1980-01-01", "first_name": "Ada", "last_name": "Lovelace", "sex": "F" }, "role": "proband", "specimen_barcode": "BC-001" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-002", "demographics": { "first_name": "Grace", "last_name": "Lovelace" }, "role": "mother", "specimen_barcode": "BC-002" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-003", "demographics": { "first_name": "Alan", "last_name": "Lovelace" }, "role": "father", "specimen_barcode": "BC-003" } ], "proband_report_delivered_at": "2026-04-08T12:00:00Z", "scenario": "home_buccal_kit", "site_euid": "SITE-LSMC" }, "properties": { "clinical_notes": { "type": "string" }, "customer_case_id": { "type": "string" }, "customer_order_id": { "type": "string" }, "external_refs": { "items": { "$ref": "#/components/schemas/ExternalRefRequest" }, "type": "array" }, "metadata": { "additionalProperties": true, "description": "Opaque order metadata. Simulation callers may set simulation_result_sample to HG005, HG006, or HG007 to select the proband bundle; LabCore assigns each comparator a different remaining bundle. Other values are rejected.", "type": "object" }, "order_tests": { "items": { "$ref": "#/components/schemas/OrderTestCreateRequest" }, "maxItems": 1, "minItems": 1, "type": "array" }, "order_type": { "example": "CLINICAL", "type": "string" }, "patients": { "description": "Exactly one proband plus at most two comparator-family participants. The three-participant maximum guarantees a distinct HG005, HG006, or HG007 simulation result bundle for every active participant.", "items": { "$ref": "#/components/schemas/PatientCreateRequest" }, "maxItems": 3, "minItems": 1, "type": "array" }, "proband_report_delivered_at": { "description": "Timestamp used to enforce the comparator update window.", "format": "date-time", "type": "string" }, "scenario": { "description": "Deterministic scenario selector. Defaults to happy_path. Non-default values are accepted only when deterministic testing is enabled for the deployment.", "enum": [ "happy_path", "home_buccal_kit", "comparator_update", "cancellation", "shipping_failure_reshipment", "accessioning_irrecoverable_redraw", "accessioning_recoverable_missing_info", "accessioning_recoverable_mismatch", "accessioning_no_matching_order", "extraction_irrecoverable_redraw", "lc_irrecoverable_redraw", "rework_recovery_loop", "pre_analysis_missing_required_metadata", "pre_results_metadata_reconciliation", "customer_hold" ], "type": "string" }, "site_euid": { "type": "string" } }, "required": [ "customer_order_id", "customer_case_id", "site_euid", "patients", "order_tests" ], "type": "object" }, "OrderCreateResponse": { "properties": { "accepted": { "type": "boolean" }, "idempotent_replay": { "type": "boolean" }, "identity_map": { "$ref": "#/components/schemas/OrderCreateIdentityMap" }, "order": { "$ref": "#/components/schemas/OrderSummaryResponse" }, "order_tests": { "items": { "$ref": "#/components/schemas/OrderCreateTestResponse" }, "type": "array" }, "request_id": { "type": "string" } }, "required": [ "accepted", "idempotent_replay", "request_id", "order", "order_tests", "identity_map" ], "type": "object" }, "OrderCreateTestResponse": { "properties": { "customer_test_id": { "type": "string" }, "order_test_euid": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "OrderListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/OrderReadResponse" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" }, "OrderReadResponse": { "properties": { "identity_map": { "$ref": "#/components/schemas/IdentityMap" }, "order": { "$ref": "#/components/schemas/OrderResponse" }, "results": { "$ref": "#/components/schemas/ResultsResponse" } }, "type": "object" }, "OrderResponse": { "properties": { "canceled_at": { "format": "date-time", "type": "string" }, "cancellation_reason": { "type": "string" }, "order_euid": { "type": "string" }, "order_tests": { "items": { "$ref": "#/components/schemas/OrderTestResponse" }, "type": "array" }, "proband_report_delivered_at": { "format": "date-time", "type": "string" }, "scenario": { "enum": [ "happy_path", "home_buccal_kit", "comparator_update", "cancellation", "shipping_failure_reshipment", "accessioning_irrecoverable_redraw", "accessioning_recoverable_missing_info", "accessioning_recoverable_mismatch", "accessioning_no_matching_order", "extraction_irrecoverable_redraw", "lc_irrecoverable_redraw", "rework_recovery_loop", "pre_analysis_missing_required_metadata", "pre_results_metadata_reconciliation", "customer_hold" ], "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "OrderSummaryResponse": { "properties": { "order_euid": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "OrderTestCreateRequest": { "properties": { "clinical_notes": { "type": "string" }, "customer_test_id": { "type": "string" }, "fulfillment_routes": { "items": { "properties": { "fulfillment_route_code": { "example": "WGS", "type": "string" } }, "required": [ "fulfillment_route_code" ], "type": "object" }, "type": "array" }, "priority": { "type": "string" }, "specimen_type": { "type": "string" } }, "required": [ "customer_test_id", "fulfillment_routes" ], "type": "object" }, "OrderTestResponse": { "properties": { "customer_test_id": { "type": "string" }, "order_test_euid": { "type": "string" }, "product_code": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "OrderUpdateEventResponse": { "properties": { "accession_euid": { "type": "string" }, "customer_patient_id": { "type": "string" }, "event_id": { "type": "string" }, "patient_euid": { "type": "string" }, "role": { "type": "string" }, "specimen_euid": { "type": "string" }, "status": { "type": "string" } }, "required": [ "customer_patient_id", "status", "event_id" ], "type": "object" }, "OrderUpdatePatientRequest": { "properties": { "collection_date": { "description": "Optional date-only specimen collection date from the comparator order or requisition, formatted YYYY-MM-DD.", "format": "date", "type": "string" }, "collection_method": { "enum": [ "blood", "home_buccal_kit" ], "type": "string" }, "customer_patient_id": { "type": "string" }, "demographics": { "properties": { "date_of_birth": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "mrn": { "type": "string" }, "sex": { "type": "string" } }, "required": [ "first_name", "last_name" ], "type": "object" }, "role": { "enum": [ "mother", "father", "comparator" ], "type": "string" }, "specimen_barcode": { "type": "string" } }, "required": [ "role", "customer_patient_id" ], "type": "object" }, "OrderUpdateRequest": { "example": { "modification_type": "comparator_add", "patient": { "collection_date": "2026-07-01", "collection_method": "blood", "customer_patient_id": "INF-PT-004", "demographics": { "first_name": "Katherine", "last_name": "Johnson" }, "role": "comparator", "specimen_barcode": "BC-004" }, "updated_by": "inflection-api" }, "properties": { "metadata": { "additionalProperties": true, "type": "object" }, "modification_type": { "enum": [ "comparator_add", "comparator_remove" ], "type": "string" }, "patient": { "allOf": [ { "$ref": "#/components/schemas/OrderUpdatePatientRequest" } ], "description": "Backward-compatible singular comparator mutation. Do not provide with patients." }, "patients": { "description": "Batch comparator mutations. The same modification_type applies to every participant, and LabCore emits one E-50 command event per participant. Comparator additions that would exceed three active participants are rejected before side effects so every participant retains a distinct simulation result bundle. Do not provide with patient.", "items": { "$ref": "#/components/schemas/OrderUpdatePatientRequest" }, "minItems": 1, "type": "array" }, "updated_by": { "type": "string" } }, "required": [ "modification_type", "updated_by" ], "type": "object" }, "OrderUpdateResponse": { "example": { "accepted": true, "event_id": "M-EVT-A4", "events": [ { "customer_patient_id": "INF-PT-004", "event_id": "M-EVT-A4", "role": "comparator", "status": "accepted" }, { "customer_patient_id": "INF-PT-005", "event_id": "M-EVT-B2", "role": "comparator", "status": "accepted" } ], "idempotent_replay": false, "modification_type": "comparator_add", "order_euid": "M-TRF-1V", "request_id": "req-001", "status": "accepted" }, "properties": { "accepted": { "type": "boolean" }, "event_id": { "type": "string" }, "events": { "description": "Batch-only per-participant command events. Each item is one accepted comparator mutation and one E-50 event.", "items": { "$ref": "#/components/schemas/OrderUpdateEventResponse" }, "type": "array" }, "idempotent_replay": { "type": "boolean" }, "modification_type": { "type": "string" }, "order_euid": { "type": "string" }, "request_id": { "type": "string" }, "status": { "type": "string" } }, "required": [ "accepted", "idempotent_replay", "request_id", "order_euid", "modification_type", "status", "event_id" ], "type": "object" }, "PatientCreateRequest": { "properties": { "collection_date": { "description": "Optional date-only specimen collection date from the order or requisition, formatted YYYY-MM-DD.", "format": "date", "type": "string" }, "collection_method": { "enum": [ "blood", "home_buccal_kit" ], "type": "string" }, "customer_patient_id": { "type": "string" }, "demographics": { "properties": { "date_of_birth": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "mrn": { "type": "string" }, "sex": { "type": "string" } }, "required": [ "first_name", "last_name" ], "type": "object" }, "role": { "enum": [ "proband", "mother", "father", "comparator" ], "example": "proband", "type": "string" }, "specimen_barcode": { "type": "string" } }, "required": [ "role", "customer_patient_id", "demographics" ], "type": "object" }, "RelatedParticipant": { "properties": { "customer_patient_id": { "example": "INF-PT-MOTHER", "type": "string" }, "patient_euid": { "example": "M-PAT-3D", "type": "string" }, "role": { "example": "mother", "type": "string" }, "specimen_euid": { "example": "M-SPEC-4E", "type": "string" }, "status": { "example": "accepted", "type": "string" } }, "type": "object" }, "ResultsResponse": { "properties": { "artifacts": { "items": { "$ref": "#/components/schemas/Artifact" }, "type": "array" }, "proband_status": { "description": "Current proband result/report status.", "type": "string" }, "proband_status_notes": { "description": "Non-breaking notes that qualify the proband result status, such as parent/comparator additions after report delivery.", "items": { "type": "string" }, "type": "array" }, "related_participants": { "description": "Parent/comparator participants related to the proband order.", "items": { "$ref": "#/components/schemas/RelatedParticipant" }, "type": "array" }, "release_authorized": { "type": "boolean" }, "release_packages": { "items": { "properties": { "package_euid": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "SampleCorrectionBillingRequest": { "properties": { "billing_reference": { "nullable": true, "type": "string" }, "insurance_reference": { "nullable": true, "type": "string" } }, "type": "object" }, "SampleCorrectionPatientRequest": { "properties": { "customer_patient_id": { "nullable": true, "type": "string" }, "date_of_birth": { "format": "date", "nullable": true, "type": "string" }, "email": { "format": "email", "nullable": true, "type": "string" }, "first_name": { "nullable": true, "type": "string" }, "last_name": { "nullable": true, "type": "string" }, "mrn": { "nullable": true, "type": "string" }, "phone": { "nullable": true, "type": "string" }, "sex_assigned_at_birth": { "nullable": true, "type": "string" } }, "type": "object" }, "SampleCorrectionReportingRequest": { "properties": { "institution_name": { "nullable": true, "type": "string" }, "ordering_provider_name": { "nullable": true, "type": "string" }, "ordering_provider_npi": { "nullable": true, "type": "string" }, "required_information": { "nullable": true, "type": "string" } }, "type": "object" }, "SampleCorrectionRequest": { "properties": { "billing": { "$ref": "#/components/schemas/SampleCorrectionBillingRequest" }, "clinical_context": { "nullable": true, "type": "string" }, "hold_euid": { "type": "string" }, "hold_version": { "minimum": 1, "type": "integer" }, "order_euid": { "nullable": true, "type": "string" }, "patient": { "$ref": "#/components/schemas/SampleCorrectionPatientRequest" }, "reason": { "type": "string" }, "release_customer_hold": { "type": "boolean" }, "reporting": { "$ref": "#/components/schemas/SampleCorrectionReportingRequest" }, "specimen": { "$ref": "#/components/schemas/SampleCorrectionSpecimenRequest" }, "updated_by": { "type": "string" } }, "required": [ "updated_by", "reason" ], "type": "object" }, "SampleCorrectionResponse": { "properties": { "correction_euid": { "type": "string" }, "idempotent_replay": { "type": "boolean" }, "remaining_holds": { "items": { "$ref": "#/components/schemas/SampleHoldResponse" }, "type": "array" }, "resolved_hold_euids": { "items": { "type": "string" }, "type": "array" }, "sample_euid": { "type": "string" }, "signal_status": { "enum": [ "queued", "blocked_by_remaining_hold", "not_required" ], "type": "string" }, "status": { "type": "string" } }, "required": [ "sample_euid", "correction_euid", "status", "resolved_hold_euids", "remaining_holds", "signal_status", "idempotent_replay" ], "type": "object" }, "SampleCorrectionSpecimenRequest": { "properties": { "collection_date": { "format": "date", "nullable": true, "type": "string" }, "collection_method": { "nullable": true, "type": "string" }, "expected_quantity": { "nullable": true, "type": "string" }, "expected_type": { "nullable": true, "type": "string" }, "specimen_barcode": { "nullable": true, "type": "string" } }, "type": "object" }, "SampleHoldQueueItem": { "properties": { "effective_hold": { "$ref": "#/components/schemas/SampleHoldResponse" }, "holds": { "items": { "$ref": "#/components/schemas/SampleHoldResponse" }, "type": "array" }, "matched_hold_euids": { "items": { "type": "string" }, "type": "array" }, "order_identifiers": { "$ref": "#/components/schemas/SampleOrderIdentifiers" }, "sample_euid": { "type": "string" }, "specimen_euid": { "type": "string" }, "status": { "enum": [ "IN_PROGRESS", "PROCESSING_HELD", "ANALYSIS_HELD", "RESULTS_HELD", "REDRAW_REQUIRED" ], "type": "string" } }, "required": [ "sample_euid", "order_identifiers", "status", "effective_hold", "holds", "matched_hold_euids" ], "type": "object" }, "SampleHoldQueueResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/SampleHoldQueueItem" }, "type": "array" }, "next_cursor": { "type": "string" } }, "required": [ "items" ], "type": "object" }, "SampleHoldResponse": { "properties": { "allowed_fields": { "items": { "type": "string" }, "type": "array" }, "blocked_stage": { "type": "string" }, "hold_euid": { "type": "string" }, "hold_point": { "enum": [ "pre_accession", "pre_processing", "pre_analysis", "pre_results", "redraw_required", "customer_hold" ], "type": "string" }, "hold_type": { "enum": [ "REDRAW_REQUIRED", "ORDER_RECONCILIATION_REQUIRED", "CUSTOMER_HOLD", "METADATA_RECONCILIATION_REQUIRED", "MISSING_REQUIRED_METADATA" ], "type": "string" }, "hold_version": { "minimum": 1, "type": "integer" }, "initiator": { "type": "string" }, "lifecycle_state": { "enum": [ "PRE_CHECK", "ACTIVE", "REJECTED", "CANCELED", "RELEASED", "FAILED" ], "type": "string" }, "priority": { "maximum": 5, "minimum": 1, "type": "integer" }, "raised_at": { "format": "date-time", "type": "string" }, "reason": { "type": "string" }, "reason_code": { "type": "string" }, "request_euid": { "type": "string" }, "required_action": { "enum": [ "reconcile_order", "correct_data", "release_customer_hold", "replace_specimen" ], "type": "string" }, "source_event_ids": { "items": { "type": "string" }, "type": "array" }, "update_allowed": { "type": "boolean" } }, "required": [ "hold_euid", "hold_type", "hold_version", "priority", "hold_point", "blocked_stage", "allowed_fields", "update_allowed", "required_action", "source_event_ids", "raised_at" ], "type": "object" }, "SampleOrderIdentifiers": { "properties": { "customer_order_id": { "type": "string" }, "order_euid": { "type": "string" } }, "type": "object" }, "SpecimenRedrawRequest": { "example": { "collection_date": "2026-07-01", "collection_method": "blood", "redraw_reason": "extraction_failure", "requested_by": "inflection-api", "specimen_barcode": "BC-REDRAW-002" }, "properties": { "collection_date": { "description": "Optional date-only collection date from the replacement specimen order or requisition, formatted YYYY-MM-DD.", "format": "date", "type": "string" }, "collection_method": { "enum": [ "blood", "home_buccal_kit" ], "type": "string" }, "metadata": { "additionalProperties": true, "type": "object" }, "redraw_reason": { "description": "Reason the replacement specimen is being submitted.", "type": "string" }, "requested_by": { "description": "Actor or integration that requested the redraw.", "type": "string" }, "specimen_barcode": { "description": "Required barcode for the replacement active specimen.", "type": "string" } }, "required": [ "specimen_barcode", "requested_by", "redraw_reason" ], "type": "object" }, "SpecimenRedrawResponse": { "example": { "accepted": true, "accession_euid": "M-ACC-5Z", "collection_date": "2026-07-01", "customer_patient_id": "INF-PT-001", "event_id": "M-EVT-A4", "idempotent_replay": false, "order_euid": "M-TRF-1V", "patient_euid": "M-PAT-3D", "request_id": "req-001", "role": "proband", "specimen_euid": "M-SPEC-4K", "status": "accepted", "supersedes_specimen_barcode": "BC-001", "supersedes_specimen_euid": "M-SPEC-3D" }, "properties": { "accepted": { "type": "boolean" }, "accession_euid": { "type": "string" }, "collection_date": { "format": "date", "type": "string" }, "customer_patient_id": { "type": "string" }, "event_id": { "type": "string" }, "idempotent_replay": { "type": "boolean" }, "order_euid": { "type": "string" }, "patient_euid": { "type": "string" }, "request_id": { "type": "string" }, "role": { "type": "string" }, "specimen_euid": { "type": "string" }, "status": { "type": "string" }, "supersedes_specimen_barcode": { "type": "string" }, "supersedes_specimen_euid": { "type": "string" } }, "required": [ "accepted", "idempotent_replay", "request_id", "order_euid", "customer_patient_id", "role", "patient_euid", "specimen_euid", "accession_euid", "status", "event_id" ], "type": "object" }, "WebhookAttempt": { "properties": { "attempt_number": { "type": "integer" }, "duration_millis": { "format": "int64", "type": "integer" }, "error_summary": { "type": "string" }, "id": { "type": "string" }, "requested_at": { "format": "date-time", "type": "string" }, "response_body_summary": { "type": "string" }, "response_status": { "type": "integer" }, "signature_headers": { "additionalProperties": true, "type": "object" } }, "type": "object" }, "WebhookDeliveryListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/WebhookDeliveryResponse" }, "type": "array" }, "total": { "type": "integer" } }, "type": "object" }, "WebhookDeliveryResponse": { "properties": { "attempt_count": { "type": "integer" }, "attempts": { "items": { "$ref": "#/components/schemas/WebhookAttempt" }, "type": "array" }, "event_id": { "type": "string" }, "id": { "type": "string" }, "last_error": { "type": "string" }, "next_attempt_at": { "format": "date-time", "type": "string" }, "registration_id": { "type": "string" }, "status": { "enum": [ "queued", "sending", "delivered", "retry_scheduled", "failed", "canceled" ], "type": "string" }, "terminal_at": { "description": "Set only when delivery succeeds or fails after exhausting configured retries; cleared if the delivery is reopened.", "format": "date-time", "type": "string" } }, "type": "object" }, "WebhookRegistrationAuth": { "properties": { "audience": { "description": "OAuth audience for inline client-credentials auth.", "type": "string" }, "client_id": { "description": "OAuth client ID for inline client-credentials auth.", "type": "string" }, "client_secret": { "description": "OAuth client secret for inline client-credentials auth.", "type": "string", "writeOnly": true }, "profile": { "description": "Configured OAuth client-credentials profile name, such as inflection.", "type": "string" }, "token": { "description": "Static bearer token for bearer webhook auth.", "type": "string", "writeOnly": true }, "token_url": { "description": "OAuth token endpoint for inline client-credentials auth.", "format": "uri", "type": "string" }, "type": { "enum": [ "hmac", "bearer", "oauth_client_credentials" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "WebhookRegistrationAuthResponse": { "properties": { "profile": { "description": "Configured OAuth profile name when one is used.", "type": "string" }, "type": { "enum": [ "hmac", "bearer", "oauth_client_credentials" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "WebhookRegistrationListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/WebhookRegistrationResponse" }, "type": "array" }, "total": { "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "WebhookRegistrationRequest": { "properties": { "auth": { "$ref": "#/components/schemas/WebhookRegistrationAuth" }, "event_types": { "items": { "type": "string" }, "type": "array" }, "secret": { "type": "string", "writeOnly": true }, "url": { "format": "uri", "type": "string" } }, "required": [ "url", "secret" ], "type": "object" }, "WebhookRegistrationResponse": { "properties": { "active": { "type": "boolean" }, "auth": { "$ref": "#/components/schemas/WebhookRegistrationAuthResponse" }, "created_at": { "format": "date-time", "type": "string" }, "event_types": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "type": "object" } }, "securitySchemes": { "customerBearer": { "description": "Fixed v0 customer bearer token from CUSTOMER_API_TOKEN.", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Partner-facing LSMC Platform API for orders, kit requests, sample holds and reconciliation, artifacts, and webhooks. Use canonical /api/v1/partner operations; /api/ext/v1 operations are deprecated compatibility aliases.", "title": "🧬 LSMC Platform API", "version": "0.1.0" }, "openapi": "3.0.3", "paths": { "/api/ext/v1/artifacts": { "get": { "deprecated": true, "operationId": "legacyListArtifacts", "parameters": [ { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/CustomerCaseID" }, { "$ref": "#/components/parameters/CustomerPatientID" }, { "$ref": "#/components/parameters/LabCoreContainerEUID" }, { "$ref": "#/components/parameters/LabCoreSpecimenEUID" }, { "$ref": "#/components/parameters/ShipmentBarcode" }, { "$ref": "#/components/parameters/TestkitBarcode" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/OrderTestEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactListResponse" } } }, "description": "Matching artifact projections", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List artifacts by exactly one supported reference filter", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/artifacts" } }, "/api/ext/v1/artifacts/{artifact_euid}": { "get": { "deprecated": true, "operationId": "legacyGetArtifact", "parameters": [ { "$ref": "#/components/parameters/ArtifactID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactReadResponse" } } }, "description": "Artifact projection", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Read artifact metadata", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/artifacts/{artifact_euid}" } }, "/api/ext/v1/artifacts/{artifact_euid}/download-url": { "get": { "deprecated": true, "description": "Returns a temporary signed download URL for the single artifact_euid in the path. Multi-file analysis deliveries announced by analysis_data_available list one artifact_euid per delivered file in payload.delivery.files[]. Call this endpoint once for each file that should be downloaded. In deployed s3_presign mode, LabCore returns a S3 presigned GET URL for s3:// artifact storage_uri values and an expiring LabCore token URL for other storage schemes.", "operationId": "legacyGetArtifactDownloadURL", "parameters": [ { "$ref": "#/components/parameters/ArtifactID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactDownloadResponse" } } }, "description": "Artifact download URL and expiration metadata", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Mint a fetchable URL for one API-managed artifact", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/artifacts/{artifact_euid}/download-url" } }, "/api/ext/v1/external-holds": { "post": { "deprecated": true, "operationId": "legacyCreatePartnerExternalHold", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldCreateResponse" } } }, "description": "External hold entered pre-check" }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Request an INFL external hold", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/external-holds" } }, "/api/ext/v1/external-holds/{hold_euid}/cancel": { "post": { "deprecated": true, "operationId": "legacyCancelPartnerExternalHold", "parameters": [ { "in": "path", "name": "hold_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldTransitionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldResponse" } } }, "description": "External hold canceled" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Cancel an external hold", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/external-holds/{hold_euid}/cancel" } }, "/api/ext/v1/external-holds/{hold_euid}/release": { "post": { "deprecated": true, "operationId": "legacyReleasePartnerExternalHold", "parameters": [ { "in": "path", "name": "hold_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldTransitionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldResponse" } } }, "description": "External hold released" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Release an external hold", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/external-holds/{hold_euid}/release" } }, "/api/ext/v1/external-holds/{request_euid}": { "get": { "deprecated": true, "operationId": "legacyGetPartnerExternalHold", "parameters": [ { "in": "path", "name": "request_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldListResponse" } } }, "description": "External hold request state" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Read an external hold request", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/external-holds/{request_euid}" } }, "/api/ext/v1/kit-orders": { "get": { "deprecated": true, "description": "List LabCore kit orders in the authenticated partner scope, optionally filtered by INFL customer_order_id. When customer_order_id is supplied, LabCore resolves it through the inflection external identifier binding before filtering kit orders. Do not send order_id; use customer_order_id for the partner/customer order identifier.", "operationId": "legacyListPartnerKitOrders", "parameters": [ { "$ref": "#/components/parameters/RequestID" }, { "$ref": "#/components/parameters/CustomerOrderID" }, { "in": "query", "name": "status", "schema": { "type": "string" } }, { "in": "query", "name": "sku", "schema": { "enum": [ "5501", "5504", "5505" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "default": 100, "maximum": 100, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderListResponse" } } }, "description": "Kit orders", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List partner kit orders", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/kit-orders" }, "post": { "deprecated": true, "description": "Create a local kit order in the authenticated partner scope and queue BioTouch submission. Optional customer_order_id is an INFL-owned external identifier; LabCore resolves it to an existing clinical order before linking the kit order. Do not send order_id; customer_order_id is not LabCore internal orders.id, a BioTouch order number, or a Meridian order_euid/TRF EUID.", "operationId": "legacyCreatePartnerKitOrder", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "linked_kit_order": { "summary": "Send three kits to one address and associate them with an INFL order", "value": { "customer_order_id": "INF-ORDER-001", "quantity": 3, "recipient": { "address1": "123 Main St", "city": "Atlanta", "country": "US", "ship_to": "Jane Patient", "state": "GA", "zip": "30301" }, "sku": "5504" } } }, "schema": { "$ref": "#/components/schemas/KitOrderCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderCreateResponse" } } }, "description": "Kit order created and BioTouch submission queued", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Create a partner kit order", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/kit-orders" } }, "/api/ext/v1/kit-orders/{kit_order_euid}": { "get": { "deprecated": true, "operationId": "legacyGetPartnerKitOrder", "parameters": [ { "$ref": "#/components/parameters/RequestID" }, { "in": "path", "name": "kit_order_euid", "required": true, "schema": { "example": "M-K1T-16", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderReadResponse" } } }, "description": "Kit order", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "500": { "$ref": "#/components/responses/InternalServerErrorLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Read a partner kit order", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/kit-orders/{kit_order_euid}" } }, "/api/ext/v1/orders": { "get": { "deprecated": true, "operationId": "legacyListOrders", "parameters": [ { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/CustomerCaseID" }, { "$ref": "#/components/parameters/CustomerPatientID" }, { "$ref": "#/components/parameters/LabCoreContainerEUID" }, { "$ref": "#/components/parameters/LabCoreSpecimenEUID" }, { "$ref": "#/components/parameters/ShipmentBarcode" }, { "$ref": "#/components/parameters/TestkitBarcode" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/OrderTestEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderListResponse" } } }, "description": "Matching order projections", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List orders by exactly one supported reference filter", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders" }, "post": { "deprecated": true, "operationId": "legacyCreateOrder", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "trio_order": { "summary": "Create one proband plus two comparator-family participants with distinct simulation results", "value": { "customer_case_id": "CASE-1001", "customer_order_id": "INFL-1001", "metadata": { "workflow_seed": "seed-001" }, "order_tests": [ { "customer_test_id": "TEST-001", "fulfillment_routes": [ { "fulfillment_route_code": "WGS" } ], "priority": "NORMAL", "specimen_type": "blood" } ], "order_type": "CLINICAL", "patients": [ { "collection_date": "2026-07-01", "collection_method": "blood", "customer_patient_id": "INF-PT-001", "demographics": { "date_of_birth": "1980-01-01", "first_name": "Ada", "last_name": "Lovelace", "sex": "F" }, "role": "proband", "specimen_barcode": "BC-001" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-002", "demographics": { "first_name": "Grace", "last_name": "Lovelace" }, "role": "mother", "specimen_barcode": "BC-002" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-003", "demographics": { "first_name": "Alan", "last_name": "Lovelace" }, "role": "father", "specimen_barcode": "BC-003" } ], "site_euid": "SITE-LSMC" } } }, "schema": { "$ref": "#/components/schemas/OrderCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCreateResponse" } } }, "description": "Order persisted and Temporal workflow started", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "403": { "$ref": "#/components/responses/ForbiddenLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCreateResponse" } } }, "description": "Temporal workflow start failed after order persistence", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } } }, "security": [ { "customerBearer": [] } ], "summary": "Create an order", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders" } }, "/api/ext/v1/orders/{id}": { "get": { "deprecated": true, "operationId": "legacyGetOrder", "parameters": [ { "$ref": "#/components/parameters/ID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderReadResponse" } } }, "description": "Order projection", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Read order detail by internal order ID or TRF EUID", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders/{id}" }, "patch": { "deprecated": true, "operationId": "legacyUpdateOrder", "parameters": [ { "$ref": "#/components/parameters/ID" }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "batch_comparator_add": { "summary": "Batch comparator update with one E-50 command event per participant", "value": { "modification_type": "comparator_add", "patients": [ { "collection_method": "blood", "customer_patient_id": "INF-PT-004", "demographics": { "first_name": "Katherine", "last_name": "Johnson" }, "role": "comparator", "specimen_barcode": "BC-004" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-005", "demographics": { "first_name": "Dorothy", "last_name": "Vaughan" }, "role": "comparator", "specimen_barcode": "BC-005" } ], "updated_by": "inflection-api" } }, "parent_add": { "summary": "Add a parent/comparator participant during the comparator window", "value": { "modification_type": "comparator_add", "patient": { "collection_method": "blood", "customer_patient_id": "INF-PT-MOTHER", "role": "mother", "specimen_barcode": "BC-MOTHER-001" }, "updated_by": "inflection-api" } }, "singular_comparator_add": { "summary": "Backward-compatible one-comparator update", "value": { "modification_type": "comparator_add", "patient": { "collection_date": "2026-07-01", "collection_method": "blood", "customer_patient_id": "INF-PT-004", "demographics": { "first_name": "Katherine", "last_name": "Johnson" }, "role": "comparator", "specimen_barcode": "BC-004" }, "updated_by": "inflection-api" } } }, "schema": { "$ref": "#/components/schemas/OrderUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderUpdateResponse" } } }, "description": "Order update accepted or replayed", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Update an order with launch-scope comparator changes", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders/{id}" } }, "/api/ext/v1/orders/{id}/cancel": { "post": { "deprecated": true, "operationId": "legacyCancelOrder", "parameters": [ { "$ref": "#/components/parameters/ID" }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCancellationRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCancellationResponse" } } }, "description": "Order cancellation accepted or replayed", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Cancel an active order", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders/{id}/cancel" } }, "/api/ext/v1/orders/{order_id}/patients/{customer_patient_id}/specimens": { "post": { "deprecated": true, "description": "Accepts a new active specimen for an existing proband or parent/comparator participant. The previous active specimen is superseded but retained in LabCore history. Newly added parents/comparators must first be added through PATCH /api/ext/v1/orders/{id}.", "operationId": "legacyAddSpecimenRedraw", "parameters": [ { "description": "Internal order ID or order_euid/TRF EUID.", "in": "path", "name": "order_id", "required": true, "schema": { "type": "string" } }, { "description": "Customer patient identifier for the existing order participant.", "in": "path", "name": "customer_patient_id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "parent_comparator_redraw": { "summary": "Replacement specimen for an existing parent/comparator", "value": { "collection_method": "blood", "redraw_reason": "visual_qc_failure", "requested_by": "inflection-api", "specimen_barcode": "BC-MOTHER-REDRAW-002" } }, "proband_redraw": { "summary": "Replacement specimen for the proband", "value": { "collection_method": "blood", "redraw_reason": "extraction_failure", "requested_by": "inflection-api", "specimen_barcode": "BC-PROBAND-REDRAW-002" } } }, "schema": { "$ref": "#/components/schemas/SpecimenRedrawRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecimenRedrawResponse" } } }, "description": "Replacement specimen accepted or idempotently replayed", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Add a redraw specimen for an existing order participant", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/orders/{order_id}/patients/{customer_patient_id}/specimens" } }, "/api/ext/v1/samples/holds": { "get": { "deprecated": true, "description": "Returns the authenticated partner's current actionable sample work queue. Repeating one filter is OR; different filter dimensions are AND. Each returned item includes every active hold and identifies which holds matched the filters.", "operationId": "legacyListPartnerSampleHolds", "parameters": [ { "$ref": "#/components/parameters/SampleHoldType" }, { "$ref": "#/components/parameters/EffectiveSampleHoldType" }, { "$ref": "#/components/parameters/SampleHoldPoint" }, { "$ref": "#/components/parameters/SampleHoldStatus" }, { "$ref": "#/components/parameters/SampleHoldUpdateAllowed" }, { "$ref": "#/components/parameters/SampleHoldRequiredAction" }, { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/SampleEUIDQuery" }, { "$ref": "#/components/parameters/SpecimenEUIDQuery" }, { "$ref": "#/components/parameters/SampleHoldRaisedAfter" }, { "$ref": "#/components/parameters/SampleHoldRaisedBefore" }, { "$ref": "#/components/parameters/SampleHoldSort" }, { "$ref": "#/components/parameters/SampleHoldLimit" }, { "$ref": "#/components/parameters/SampleHoldCursor" }, { "$ref": "#/components/parameters/RequestID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleHoldQueueResponse" } } }, "description": "Current actionable sample holds" }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "500": { "$ref": "#/components/responses/InternalServerErrorLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List actionable sample holds", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/samples/holds" } }, "/api/ext/v1/samples/{sample_euid}": { "patch": { "deprecated": true, "description": "Applies a presence-aware correction to customer-submitted data, reevaluates compatible holds, and queues the workflow release signal. Observed accessioning and laboratory facts are immutable.", "operationId": "legacyReconcilePartnerSample", "parameters": [ { "in": "path", "name": "sample_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleCorrectionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleCorrectionResponse" } } }, "description": "Correction accepted and workflow reconciliation queued" }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "409": { "$ref": "#/components/responses/ConflictLegacy" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Correction does not address the referenced hold" }, "500": { "$ref": "#/components/responses/InternalServerErrorLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Reconcile customer-submitted sample data", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/samples/{sample_euid}" } }, "/api/ext/v1/webhooks": { "get": { "deprecated": true, "operationId": "legacyListWebhooks", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationListResponse" } } }, "description": "Active webhook registrations without secrets", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List active webhook registrations", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/webhooks" }, "post": { "deprecated": true, "operationId": "legacyRegisterWebhook", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationResponse" } } }, "description": "Webhook registration created", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "400": { "$ref": "#/components/responses/BadRequestLegacy" }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Register a partner webhook endpoint", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/webhooks" } }, "/api/ext/v1/webhooks/deliveries": { "get": { "deprecated": true, "operationId": "legacyListWebhookDeliveries", "parameters": [ { "in": "query", "name": "event_id", "schema": { "type": "string" } }, { "in": "query", "name": "status", "schema": { "enum": [ "queued", "sending", "delivered", "retry_scheduled", "failed", "canceled" ], "type": "string" } }, { "in": "query", "name": "registration_id", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/TRFEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryListResponse" } } }, "description": "Webhook delivery records", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "List webhook delivery records", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/webhooks/deliveries" } }, "/api/ext/v1/webhooks/deliveries/{id}": { "get": { "deprecated": true, "operationId": "legacyGetWebhookDelivery", "parameters": [ { "$ref": "#/components/parameters/ID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryResponse" } } }, "description": "Webhook delivery detail with attempts", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Read webhook delivery detail", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/webhooks/deliveries/{id}" } }, "/api/ext/v1/webhooks/{registration_id}": { "delete": { "deprecated": true, "operationId": "legacyUnregisterWebhook", "parameters": [ { "in": "path", "name": "registration_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Webhook registration is inactive", "headers": { "Deprecation": { "$ref": "#/components/headers/Deprecation" }, "Link": { "$ref": "#/components/headers/MigrationLink" }, "Sunset": { "$ref": "#/components/headers/Sunset" } } }, "401": { "$ref": "#/components/responses/UnauthorizedLegacy" }, "404": { "$ref": "#/components/responses/NotFoundLegacy" }, "500": { "$ref": "#/components/responses/InternalServerErrorLegacy" } }, "security": [ { "customerBearer": [] } ], "summary": "Unregister a partner webhook endpoint", "tags": [ "deprecated-partner-routes" ], "x-lsmc-deprecation-window-days": 90, "x-lsmc-replacement": "/api/v1/partner/webhooks/{registration_id}" } }, "/api/v1/partner/artifacts": { "get": { "operationId": "listArtifacts", "parameters": [ { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/CustomerCaseID" }, { "$ref": "#/components/parameters/CustomerPatientID" }, { "$ref": "#/components/parameters/LabCoreContainerEUID" }, { "$ref": "#/components/parameters/LabCoreSpecimenEUID" }, { "$ref": "#/components/parameters/ShipmentBarcode" }, { "$ref": "#/components/parameters/TestkitBarcode" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/OrderTestEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactListResponse" } } }, "description": "Matching artifact projections" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "security": [ { "customerBearer": [] } ], "summary": "List artifacts by exactly one supported reference filter", "tags": [ "artifacts" ] } }, "/api/v1/partner/artifacts/{artifact_euid}": { "get": { "operationId": "getArtifact", "parameters": [ { "$ref": "#/components/parameters/ArtifactID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactReadResponse" } } }, "description": "Artifact projection" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" } }, "security": [ { "customerBearer": [] } ], "summary": "Read artifact metadata", "tags": [ "artifacts" ] } }, "/api/v1/partner/artifacts/{artifact_euid}/download-url": { "get": { "description": "Returns a temporary signed download URL for the single artifact_euid in the path. Multi-file analysis deliveries announced by analysis_data_available list one artifact_euid per delivered file in payload.delivery.files[]. Call this endpoint once for each file that should be downloaded. In deployed s3_presign mode, LabCore returns a S3 presigned GET URL for s3:// artifact storage_uri values and an expiring LabCore token URL for other storage schemes.", "operationId": "getArtifactDownloadURL", "parameters": [ { "$ref": "#/components/parameters/ArtifactID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtifactDownloadResponse" } } }, "description": "Artifact download URL and expiration metadata" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" } }, "security": [ { "customerBearer": [] } ], "summary": "Mint a fetchable URL for one API-managed artifact", "tags": [ "artifacts" ] } }, "/api/v1/partner/external-holds": { "post": { "operationId": "createPartnerExternalHold", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldCreateResponse" } } }, "description": "External hold entered pre-check" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Request an INFL external hold", "tags": [ "external-holds" ] } }, "/api/v1/partner/external-holds/{hold_euid}/cancel": { "post": { "operationId": "cancelPartnerExternalHold", "parameters": [ { "in": "path", "name": "hold_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldTransitionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldResponse" } } }, "description": "External hold canceled" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Cancel an external hold", "tags": [ "external-holds" ] } }, "/api/v1/partner/external-holds/{hold_euid}/release": { "post": { "operationId": "releasePartnerExternalHold", "parameters": [ { "in": "path", "name": "hold_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldTransitionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldResponse" } } }, "description": "External hold released" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Release an external hold", "tags": [ "external-holds" ] } }, "/api/v1/partner/external-holds/{request_euid}": { "get": { "operationId": "getPartnerExternalHold", "parameters": [ { "in": "path", "name": "request_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalHoldListResponse" } } }, "description": "External hold request state" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" } }, "security": [ { "customerBearer": [] } ], "summary": "Read an external hold request", "tags": [ "external-holds" ] } }, "/api/v1/partner/kit-orders": { "get": { "description": "List LabCore kit orders in the authenticated partner scope, optionally filtered by INFL customer_order_id. When customer_order_id is supplied, LabCore resolves it through the inflection external identifier binding before filtering kit orders. Do not send order_id; use customer_order_id for the partner/customer order identifier.", "operationId": "listPartnerKitOrders", "parameters": [ { "$ref": "#/components/parameters/RequestID" }, { "$ref": "#/components/parameters/CustomerOrderID" }, { "in": "query", "name": "status", "schema": { "type": "string" } }, { "in": "query", "name": "sku", "schema": { "enum": [ "5501", "5504", "5505" ], "type": "string" } }, { "in": "query", "name": "limit", "schema": { "default": 100, "maximum": 100, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderListResponse" } } }, "description": "Kit orders" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "List partner kit orders", "tags": [ "kit-orders" ] }, "post": { "description": "Create a local kit order in the authenticated partner scope and queue BioTouch submission. Optional customer_order_id is an INFL-owned external identifier; LabCore resolves it to an existing clinical order before linking the kit order. Do not send order_id; customer_order_id is not LabCore internal orders.id, a BioTouch order number, or a Meridian order_euid/TRF EUID.", "operationId": "createPartnerKitOrder", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "linked_kit_order": { "summary": "Send three kits to one address and associate them with an INFL order", "value": { "customer_order_id": "INF-ORDER-001", "quantity": 3, "recipient": { "address1": "123 Main St", "city": "Atlanta", "country": "US", "ship_to": "Jane Patient", "state": "GA", "zip": "30301" }, "sku": "5504" } } }, "schema": { "$ref": "#/components/schemas/KitOrderCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderCreateResponse" } } }, "description": "Kit order created and BioTouch submission queued" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Create a partner kit order", "tags": [ "kit-orders" ] } }, "/api/v1/partner/kit-orders/{kit_order_euid}": { "get": { "operationId": "getPartnerKitOrder", "parameters": [ { "$ref": "#/components/parameters/RequestID" }, { "in": "path", "name": "kit_order_euid", "required": true, "schema": { "example": "M-K1T-16", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KitOrderReadResponse" } } }, "description": "Kit order" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "security": [ { "customerBearer": [] } ], "summary": "Read a partner kit order", "tags": [ "kit-orders" ] } }, "/api/v1/partner/orders": { "get": { "operationId": "listOrders", "parameters": [ { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/CustomerCaseID" }, { "$ref": "#/components/parameters/CustomerPatientID" }, { "$ref": "#/components/parameters/LabCoreContainerEUID" }, { "$ref": "#/components/parameters/LabCoreSpecimenEUID" }, { "$ref": "#/components/parameters/ShipmentBarcode" }, { "$ref": "#/components/parameters/TestkitBarcode" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/OrderTestEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderListResponse" } } }, "description": "Matching order projections" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "security": [ { "customerBearer": [] } ], "summary": "List orders by exactly one supported reference filter", "tags": [ "orders" ] }, "post": { "operationId": "createOrder", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "trio_order": { "summary": "Create one proband plus two comparator-family participants with distinct simulation results", "value": { "customer_case_id": "CASE-1001", "customer_order_id": "INFL-1001", "metadata": { "workflow_seed": "seed-001" }, "order_tests": [ { "customer_test_id": "TEST-001", "fulfillment_routes": [ { "fulfillment_route_code": "WGS" } ], "priority": "NORMAL", "specimen_type": "blood" } ], "order_type": "CLINICAL", "patients": [ { "collection_date": "2026-07-01", "collection_method": "blood", "customer_patient_id": "INF-PT-001", "demographics": { "date_of_birth": "1980-01-01", "first_name": "Ada", "last_name": "Lovelace", "sex": "F" }, "role": "proband", "specimen_barcode": "BC-001" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-002", "demographics": { "first_name": "Grace", "last_name": "Lovelace" }, "role": "mother", "specimen_barcode": "BC-002" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-003", "demographics": { "first_name": "Alan", "last_name": "Lovelace" }, "role": "father", "specimen_barcode": "BC-003" } ], "site_euid": "SITE-LSMC" } } }, "schema": { "$ref": "#/components/schemas/OrderCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCreateResponse" } } }, "description": "Order persisted and Temporal workflow started" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCreateResponse" } } }, "description": "Temporal workflow start failed after order persistence" } }, "security": [ { "customerBearer": [] } ], "summary": "Create an order", "tags": [ "orders" ] } }, "/api/v1/partner/orders/{id}": { "get": { "operationId": "getOrder", "parameters": [ { "$ref": "#/components/parameters/ID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderReadResponse" } } }, "description": "Order projection" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" } }, "security": [ { "customerBearer": [] } ], "summary": "Read order detail by internal order ID or TRF EUID", "tags": [ "orders" ] }, "patch": { "operationId": "updateOrder", "parameters": [ { "$ref": "#/components/parameters/ID" }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "batch_comparator_add": { "summary": "Batch comparator update with one E-50 command event per participant", "value": { "modification_type": "comparator_add", "patients": [ { "collection_method": "blood", "customer_patient_id": "INF-PT-004", "demographics": { "first_name": "Katherine", "last_name": "Johnson" }, "role": "comparator", "specimen_barcode": "BC-004" }, { "collection_method": "blood", "customer_patient_id": "INF-PT-005", "demographics": { "first_name": "Dorothy", "last_name": "Vaughan" }, "role": "comparator", "specimen_barcode": "BC-005" } ], "updated_by": "inflection-api" } }, "parent_add": { "summary": "Add a parent/comparator participant during the comparator window", "value": { "modification_type": "comparator_add", "patient": { "collection_method": "blood", "customer_patient_id": "INF-PT-MOTHER", "role": "mother", "specimen_barcode": "BC-MOTHER-001" }, "updated_by": "inflection-api" } }, "singular_comparator_add": { "summary": "Backward-compatible one-comparator update", "value": { "modification_type": "comparator_add", "patient": { "collection_date": "2026-07-01", "collection_method": "blood", "customer_patient_id": "INF-PT-004", "demographics": { "first_name": "Katherine", "last_name": "Johnson" }, "role": "comparator", "specimen_barcode": "BC-004" }, "updated_by": "inflection-api" } } }, "schema": { "$ref": "#/components/schemas/OrderUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderUpdateResponse" } } }, "description": "Order update accepted or replayed" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Update an order with launch-scope comparator changes", "tags": [ "orders" ] } }, "/api/v1/partner/orders/{id}/cancel": { "post": { "operationId": "cancelOrder", "parameters": [ { "$ref": "#/components/parameters/ID" }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCancellationRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCancellationResponse" } } }, "description": "Order cancellation accepted or replayed" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Cancel an active order", "tags": [ "orders" ] } }, "/api/v1/partner/orders/{order_id}/patients/{customer_patient_id}/specimens": { "post": { "description": "Accepts a new active specimen for an existing proband or parent/comparator participant. The previous active specimen is superseded but retained in LabCore history. Newly added parents/comparators must first be added through PATCH /api/ext/v1/orders/{id}.", "operationId": "addSpecimenRedraw", "parameters": [ { "description": "Internal order ID or order_euid/TRF EUID.", "in": "path", "name": "order_id", "required": true, "schema": { "type": "string" } }, { "description": "Customer patient identifier for the existing order participant.", "in": "path", "name": "customer_patient_id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "examples": { "parent_comparator_redraw": { "summary": "Replacement specimen for an existing parent/comparator", "value": { "collection_method": "blood", "redraw_reason": "visual_qc_failure", "requested_by": "inflection-api", "specimen_barcode": "BC-MOTHER-REDRAW-002" } }, "proband_redraw": { "summary": "Replacement specimen for the proband", "value": { "collection_method": "blood", "redraw_reason": "extraction_failure", "requested_by": "inflection-api", "specimen_barcode": "BC-PROBAND-REDRAW-002" } } }, "schema": { "$ref": "#/components/schemas/SpecimenRedrawRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecimenRedrawResponse" } } }, "description": "Replacement specimen accepted or idempotently replayed" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" } }, "security": [ { "customerBearer": [] } ], "summary": "Add a redraw specimen for an existing order participant", "tags": [ "orders" ] } }, "/api/v1/partner/samples/holds": { "get": { "description": "Returns the authenticated partner's current actionable sample work queue. Repeating one filter is OR; different filter dimensions are AND. Each returned item includes every active hold and identifies which holds matched the filters.", "operationId": "listPartnerSampleHolds", "parameters": [ { "$ref": "#/components/parameters/SampleHoldType" }, { "$ref": "#/components/parameters/EffectiveSampleHoldType" }, { "$ref": "#/components/parameters/SampleHoldPoint" }, { "$ref": "#/components/parameters/SampleHoldStatus" }, { "$ref": "#/components/parameters/SampleHoldUpdateAllowed" }, { "$ref": "#/components/parameters/SampleHoldRequiredAction" }, { "$ref": "#/components/parameters/CustomerOrderID" }, { "$ref": "#/components/parameters/OrderEUID" }, { "$ref": "#/components/parameters/SampleEUIDQuery" }, { "$ref": "#/components/parameters/SpecimenEUIDQuery" }, { "$ref": "#/components/parameters/SampleHoldRaisedAfter" }, { "$ref": "#/components/parameters/SampleHoldRaisedBefore" }, { "$ref": "#/components/parameters/SampleHoldSort" }, { "$ref": "#/components/parameters/SampleHoldLimit" }, { "$ref": "#/components/parameters/SampleHoldCursor" }, { "$ref": "#/components/parameters/RequestID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleHoldQueueResponse" } } }, "description": "Current actionable sample holds" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "security": [ { "customerBearer": [] } ], "summary": "List actionable sample holds", "tags": [ "samples" ] } }, "/api/v1/partner/samples/{sample_euid}": { "patch": { "description": "Applies a presence-aware correction to customer-submitted data, reevaluates compatible holds, and queues the workflow release signal. Observed accessioning and laboratory facts are immutable.", "operationId": "reconcilePartnerSample", "parameters": [ { "in": "path", "name": "sample_euid", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/RequestID" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleCorrectionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SampleCorrectionResponse" } } }, "description": "Correction accepted and workflow reconciliation queued" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Correction does not address the referenced hold" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "security": [ { "customerBearer": [] } ], "summary": "Reconcile customer-submitted sample data", "tags": [ "samples" ] } }, "/api/v1/partner/webhooks": { "get": { "operationId": "listWebhooks", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationListResponse" } } }, "description": "Active webhook registrations without secrets" }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "security": [ { "customerBearer": [] } ], "summary": "List active webhook registrations", "tags": [ "webhooks" ] }, "post": { "operationId": "registerWebhook", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegistrationResponse" } } }, "description": "Webhook registration created" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "security": [ { "customerBearer": [] } ], "summary": "Register a partner webhook endpoint", "tags": [ "webhooks" ] } }, "/api/v1/partner/webhooks/deliveries": { "get": { "operationId": "listWebhookDeliveries", "parameters": [ { "in": "query", "name": "event_id", "schema": { "type": "string" } }, { "in": "query", "name": "status", "schema": { "enum": [ "queued", "sending", "delivered", "retry_scheduled", "failed", "canceled" ], "type": "string" } }, { "in": "query", "name": "registration_id", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/TRFEUID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryListResponse" } } }, "description": "Webhook delivery records" }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "security": [ { "customerBearer": [] } ], "summary": "List webhook delivery records", "tags": [ "webhooks" ] } }, "/api/v1/partner/webhooks/deliveries/{id}": { "get": { "operationId": "getWebhookDelivery", "parameters": [ { "$ref": "#/components/parameters/ID" } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryResponse" } } }, "description": "Webhook delivery detail with attempts" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" } }, "security": [ { "customerBearer": [] } ], "summary": "Read webhook delivery detail", "tags": [ "webhooks" ] } }, "/api/v1/partner/webhooks/{registration_id}": { "delete": { "operationId": "unregisterWebhook", "parameters": [ { "in": "path", "name": "registration_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Webhook registration is inactive" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "security": [ { "customerBearer": [] } ], "summary": "Unregister a partner webhook endpoint", "tags": [ "webhooks" ] } } }, "servers": [ { "description": "Current API host", "url": "/" } ], "tags": [ { "description": "Order creation and reads", "name": "orders" }, { "description": "Partner-facing kit request creation and tracking", "name": "kit-orders" }, { "description": "Artifact metadata and downloads", "name": "artifacts" }, { "description": "Webhook registration and delivery inspection", "name": "webhooks" }, { "description": "Actionable sample holds and customer-submitted reconciliation", "name": "samples" }, { "description": "INFL external hold requests and lifecycle", "name": "external-holds" }, { "description": "Deprecated partner route aliases retained temporarily for customer migration.", "name": "deprecated-partner-routes" } ] }