Stop, start, or refresh a GPU instance

stop releases the running allocation and pauses billing. start redeploys the saved instance spec with fresh runtime disk. refresh re-syncs live status.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Path parameters

instance_idstringRequired

actionenumRequired

Allowed values:

Response

Action applied.

instanceobjectOptional

$	curl -X POST https://api.empiriolabs.ai/v1/gpu/instances/instance_id/stop \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"instance": {
3	"id": "gpu-inst-9f8b7c6d",
4	"status": "stopped",
5	"gpu_slug": "rtx-4090",
6	"gpu_display": "RTX 4090",
7	"num_gpus": 2,
8	"image": "ubuntu-22.04-gpu",
9	"label": "ML Training Node A",
10	"disk_gb": 500,
11	"price_hourly": 3.25,
12	"connect_path": "/v1",
13	"billed_amount": 45.75,
14	"created_at": "2024-04-10T08:15:00Z",
15	"started_at": "2024-04-10T08:20:00Z",
16	"error": null
17	}
18	}