ReferenceAPI
curl -X PATCH "https://api.nevia.cloud/v1/computers/01d4cnjk3xg90y576w8y6t4gdwm" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"protected": true
}'{
"computer": {
"id": "01d4cnjk3xg90y576w8y6t4gdwm",
"workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
"name": "api-staging",
"state": "ready",
"pending": null,
"image": "docker.io/library/python:3.13-slim",
"image_digest": "sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"ports": [
{
"published": 8080,
"target": 8080,
"protocol": "http1",
"url": "https://01d4cnjk3xg90y576w8y6t4gdwm.machines.example:8080"
}
],
"url": "https://01d4cnjk3xg90y576w8y6t4gdwm.machines.example",
"env_keys": [
"LOG_LEVEL",
"OPENAI_KEY"
],
"env_vars": [
{
"name": "LOG_LEVEL",
"source": "literal",
"missing": false
},
{
"name": "OPENAI_KEY",
"source": "secret",
"missing": false
}
],
"generation": 1,
"protected": false,
"parent": null,
"from_checkpoint": null,
"error": null,
"created_at": "2026-09-10T12:34:56Z",
"last_started_at": "2026-09-10T12:35:12Z",
"last_active_at": "2026-09-10T12:40:03Z",
"deleted_at": null
},
"operations": [
"01d4cnjm89yk0r3xtv80dy0x7by"
]
}Authorization
bearerAuth Authorization
Bearer <token>
Send the token in the Authorization: Bearer <token> header. See Authenticate.
In: header
Path Parameters
cmp*
string
Computer id: 27 lowercase letters and digits.
Match
^[A-Za-z0-9_-]{1,64}$Header Parameters
Idempotency-Key?
string
Optional retry key, kept 24 hours
Length
1 <= length <= 255Request Body
application/json
Fields to change on a computer
Behavior
- Updates to one computer run one at a time.
- With
Idempotency-Key, a retry replays the original response without reapplying an older configuration. envmerges into the stored env.nulldetaches a var.- The merged env applies from the next exec on, in any state but
deleting. - The API checks new references as in a create.
portsreplaces the mappings on the running machine.
Response
application/jsonThe computer, with operations empty.