Chaser Documentation

Create a browser or sandbox session. Workspace-backed requests reuse the live VM for that workspace when one already exists, otherwise they spawn a new one. Provide workspace (label or UUID) for persistent sessions. Set ephemeral=true to force a fresh non-persistent session without a workspace. Sandbox image is accepted only for ephemeral sessions; workspace-backed sessions inherit image from the workspace configuration.

Create a browser or sandbox session. Workspace-backed requests reuse the live VM for that workspace when one already exists, otherwise they spawn a new one. Provide `workspace` (label or UUID) for persistent sessions. Set `ephemeral=true` to force a fresh non-persistent session without a workspace. Sandbox `image` is accepted only for ephemeral sessions; workspace-backed sessions inherit image from the workspace configuration.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

CreateSessionPersistentRequestDocobjectRequired

CreateSessionEphemeralRequestDocobjectRequired

Response

Session created

created_atstring

endpointsobject

idstring

session_typestring

statusstring

active_connection_leasesinteger or null>=0

Active connection leases reported by the owning daemon (if available).

persistenceboolean or null

Whether this session's workspace is configured to persist after termination.

workspace_idstring or null

Durable workspace identity.

1	import requests
2
3	url = "https://api.chaser.sh/v1/sessions"
4
5	payload = {
6	"proxy": "DEFAULT",
7	"session_type": "sandbox",
8	"workspace": "frontend-app"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"created_at": "string",
3	"endpoints": {
4	"control": "string",
5	"video": "string"
6	},
7	"id": "string",
8	"session_type": "string",
9	"status": "string",
10	"active_connection_leases": 1,
11	"persistence": true,
12	"workspace_id": "string"
13	}

Create or reuse a session

Authentication

Request

Response

Errors