Skip to main content

​
list

List bundle requests or get details for a specific request. 
leap-bundle list [<request-id>]
Arguments
  • request-id (optional): Specific request ID to get detailed information
Options
  • --json: Output result in JSON format for programmatic parsing
  • --last: Show only the most recent request
Behavior
  • Without arguments: Lists 50 most recent bundle requests
  • With request ID: Shows detailed information for the specific request
  • With --last: Shows only the most recent request
  • Displays requests in a formatted table (unless --json is used)
  • JSON output available for both list and specific request queries
Examples 
# List all requests
leap-bundle list

# Example output
Bundle Requests (50 most recent)
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
│ 18733 │ /path/to/other/directory │ processing │ 2024-01-15T09:15:00Z │ Request is being processed. │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 2 bundle requests.

# Get details for specific request
leap-bundle list 18734

# Example output
✓ Request Details:
  ID:         18734
  Input Path: /path/to/model/directory
  Status:     completed
  Creation:   2024-01-15T10:30:00Z
  Update:     2024-01-15T10:45:00Z
  Notes:      Processing completed. Run "leap-bundle download 18734" to download the bundle.

# Get details with JSON output
leap-bundle list 18734 --json

# Example JSON output
{
  "request_id": "18734",
  "input_path": "/path/to/model/directory",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "user_message": "Processing completed. Run \"leap-bundle download 18734\" to download the bundle."
}

# List all requests with JSON output
leap-bundle list --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    },
    {
      "request_id": "18733",
      "input_path": "/path/to/other/directory",
      "status": "processing",
      "created_at": "2024-01-15T09:15:00Z",
      "user_message": "Request is being processed."
    }
  ]
}

# Show only the most recent request
leap-bundle list --last

# Example output
Most Recent Bundle Request
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 1 bundle request.

# Show most recent request with JSON output
leap-bundle list --last --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    }
  ]
}
Request Statuses
  • New: The request is newly created
  • Uploading: The model files are being uploaded
  • Uploading Failed: The upload encountered an error
  • Processing: The bundle is being processed
  • Processing Failed: Processing failed
  • Completed: The request is successfully completed and ready for download
  • Cancelled: The request is cancelled by the user
  • Archived: The request is archived and no longer available for download; this happens automatically 5 days after completion
Error Cases
  • Not authenticated: Prompts to login first
  • Request ID not found: Shows not found error
  • Network issues: Shows connection error

​
cancel

Cancel a bundle request that is still processing. 
leap-bundle cancel <request-id>
Arguments
  • request-id (required): ID of the bundle request to cancel
Behavior
  • Sends a cancellation request to the LEAP platform
  • Updates the request status to “cancelled”
  • Cannot cancel requests that are already completed or archived
Examples 
# Cancel a processing request
leap-bundle cancel 18734

# Example output on success
ℹ Cancelling bundle request 18734...
✓ Request cancelled successfully.

# Example output when request is already completed
ℹ Cancelling bundle request 18734...
✓ Request was already completed and cannot be cancelled.
Error Cases
  • Request not found: Shows request not found error
  • Request already completed: Shows informational message
  • Not authenticated: Prompts to login first
  • Network issues: Shows connection error