For a single session use Create a Session. See Browser Sessions for when to choose batch vs sync or async.
Quick Start
1. Create a Batch
2. Monitor Progress
3. Use Sessions
Polling Strategy
Parameters
Number of browser sessions to create (1-1000)
Session configuration that applies to all sessions in the batch
Optional key-value pairs for batch identification
Status States
Batch States:pending → processing → completed / failed
Session States: pending → processing → completed / failed
Available Endpoints
POST /v1/batch-sessions- Create batch sessionsGET /v1/batch-sessions/{batch_id}- Get batch status
Additional endpoints for listing, canceling, and retrying batches are planned for future releases.
Limits
- Maximum batch size: 1,000 sessions
- Session lifetime: Up to 24 hours
- Large batches may take several minutes to provision

