Export

Export dataslice metadata and/or nodes to a configured destination.

This endpoint supports exporting data from a dataslice or data connector to a destination system. For small datasets (fewer than 100 files), the export runs synchronously. For larger datasets, the export is processed in the background and returns a tracker ID for monitoring progress.

Request Body

Response

• 200: Export completed or initiated successfully
  • Returns: ExportDatasliceDestinationResponse with:
    • message: Status message
    • success: Number of successfully exported items
    • failed: Number of failed exports
    • failed_items: List of items that failed to export
    • failed_tags: List of tags that failed to export (if applicable)
    • tracker_id: Progress tracker ID for background exports (only for large datasets)
• 400: Bad Request (e.g., missing required parameters)
• 500: Internal Server Error

Example Request

{
  "dataslice_id": "550e8400-e29b-41d4-a716-446655440000",
  "destination_name": "my-destination",
  "export_tags": ["contracts", "invoices"],
  "export_level": "both",
  "export_nodes": true,
  "export_metadata": true,
  "metadata_format": "column_store"
}

Example Response (Synchronous)

{
  "message": "Export completed successfully",
  "success": 45,
  "failed": 0,
  "failed_items": [],
  "failed_tags": null,
  "tracker_id": null
}

Example Response (Background Processing)

{
  "message": "Export started in background. Use tracker_id to monitor progress.",
  "success": 0,
  "failed": 0,
  "failed_items": [],
  "failed_tags": null,
  "tracker_id": "export-12345678-90ab-cdef-1234-567890abcdef"
}