TeleFork.dev — REST API Reference

POST /v1/sandboxes

Provision Sandbox

Request Parameters

project_id	string (required)	Unique project slug
git_branch	string (required)	Target Git branch name
ttl_minutes	integer (optional)	Sandbox TTL (default: 30)

Request Payload

{ "project_id": "keya-backend", "git_branch": "feature/payments-fix", "ttl_minutes": 15 }

Response (201 Created)

{ "id": "sbx-pr24-d8f9", "status": "provisioning", "dns_endpoint": "sbx-pr24.telefork.dev", "created_at": "2026-07-30T10:37:00Z" }

GET /v1/sandboxes/{id}

Retrieve Sandbox Details

Path Variables

id

string (required)

Unique ID of the sandbox

Response (200 OK)

{ "id": "sbx-pr24-d8f9", "status": "healthy", "dns_endpoint": "sbx-pr24.telefork.dev", "cpu_shares": 512, "memory_limit_mb": 1024, "uptime_seconds": 182, "created_at": "2026-07-30T10:35:00Z" }

DELETE /v1/sandboxes/{id}

Terminate Sandbox

Path Variables

id

string (required)

Unique ID of the sandbox

Response (200 OK)

{ "id": "sbx-pr24-d8f9", "status": "terminated", "message": "Resource elements successfully deleted.", "avoided_cost_hourly": 0.24 }