ReferenceAPI

Get an operation

Get one operation to check whether it is finished or failed.

GET https://api.nevia.cloud/v1/operations/{op}

curl -X GET "https://api.nevia.cloud/v1/operations/01d4cnjm89yk0r3xtv80dy0x7by" \
  -H "Authorization: Bearer $TOKEN"

{
  "operation": {
    "id": "01d4cnjm89yk0r3xtv80dy0x7by",
    "workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
    "resource_type": "computer",
    "resource": "01d4cnjk3xg90y576w8y6t4gdwm",
    "type": "computer.create",
    "state": "running",
    "error": null,
    "created_at": "2026-09-10T12:34:56Z",
    "updated_at": "2026-09-10T12:34:58Z",
    "finished_at": null
  }
}

Authorization

bearerAuth

Authorization Bearer <token>

Send the token in the Authorization: Bearer <token> header. See Authenticate.

In: header

Path Parameters

op* string

Operation id: 27 lowercase letters and digits.

Match ^[A-Za-z0-9_-]{1,64}$

Behavior

finished and failed are terminal.

Anyone who can view the operation's workspace can poll it. So can the principal who started it.

A workspace.delete stays pollable after the workspace is gone.

Response

application/json

The operation, with the error body when it failed.

List operations

List a workspace's operations, newest first.

List workspace checkpoints

List every live checkpoint across a workspace's computers, newest first.