Chaser Documentation

Run a command over HTTP by automatically provisioning (or reusing) a sandbox session. Use ephemeral=true for stateless execution. Use workspace (name or UUID) for persistent workspace-backed execution.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

SandboxExecPersistentRequestDocobjectRequired

SandboxExecEphemeralRequestDocobjectRequired

Response

Command executed

backgroundboolean

commandstring

ephemeralboolean

kindstring

session_idstring

statusstring

command_idstring or null

exit_codeinteger or null>=0

outputstring or null

output_truncatedboolean or null

pidlong or null

workspacestring or null

workspace_idstring or null

1	curl -X POST https://api.chaser.sh/v1/exec \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"command": "npm ci && npm test",
6	"workspace": "api-dev"
7	}'

1	{
2	"background": true,
3	"command": "string",
4	"ephemeral": true,
5	"kind": "string",
6	"session_id": "string",
7	"status": "string",
8	"command_id": "string",
9	"exit_code": 1,
10	"output": "string",
11	"output_truncated": true,
12	"pid": 1,
13	"workspace": "string",
14	"workspace_id": "string"
15	}

Execute command with auto-spawned sandbox

Authentication

Request

Response

Errors