Error

A valid request URL is required to generate request examples

{
  "resources": {
    "block_input": 123,
    "block_output": 123,
    "cost": 123,
    "elapsed_time": 123,
    "involuntary_switches": 123,
    "max_rss": 123,
    "monotonic_time": 123,
    "page_faults": 123,
    "page_faults_io": 123,
    "shared_memory": 123,
    "signals": 123,
    "swaps": 123,
    "system_cpu_time": 123,
    "unshared_memory": 123,
    "user_cpu_time": 123,
    "voluntary_switches": 123
  },
  "state": {
    "continued": true,
    "core_dump": true,
    "exit_code": 123,
    "pid": 123,
    "signal": 123,
    "stopped": true,
    "timed_out": true
  },
  "stdout": {
    "value": "Y29tbWFuZCBvdXRwdXQK",
    "encoding": "base64",
    "truncated": false
  },
  "stderr": {
    "value": "Y29tbWFuZCBvdXRwdXQK",
    "encoding": "base64",
    "truncated": false
  }
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

operation

Result of one subprocess, reconstructed from its events

Returns an InstanceResult for spid — the same shape as the parent operation’s metadata.result — folded from the subprocess’s event log (spawn / stdout / stderr / exit). Works for running and terminal operations alike. While the process is still running, state.exit_code and state.signal are -1 (unknown) and resources holds sentinel defaults; once the exit event lands they carry the real values.

stdout / stderr are consolidated and capped at the spec’s truncate_output_at. The raw event stream stays available at GET /operations/{operationId}/events?spid={spid}.

GET

operations

{operationId}

subprocesses

{spid}

Error

A valid request URL is required to generate request examples

{
  "resources": {
    "block_input": 123,
    "block_output": 123,
    "cost": 123,
    "elapsed_time": 123,
    "involuntary_switches": 123,
    "max_rss": 123,
    "monotonic_time": 123,
    "page_faults": 123,
    "page_faults_io": 123,
    "shared_memory": 123,
    "signals": 123,
    "swaps": 123,
    "system_cpu_time": 123,
    "unshared_memory": 123,
    "user_cpu_time": 123,
    "voluntary_switches": 123
  },
  "state": {
    "continued": true,
    "core_dump": true,
    "exit_code": 123,
    "pid": 123,
    "signal": 123,
    "stopped": true,
    "timed_out": true
  },
  "stdout": {
    "value": "Y29tbWFuZCBvdXRwdXQK",
    "encoding": "base64",
    "truncated": false
  },
  "stderr": {
    "value": "Y29tbWFuZCBvdXRwdXQK",
    "encoding": "base64",
    "truncated": false
  }
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

{
  "error": "Some error occurred, this is an example of error message",
  "status": 500,
  "traceback": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

IAM bearer token issued by the Nebius IAM service. Sent as Authorization: Bearer <iam-token>. Must be combined with the Project header (see IAMProjectHeader).

This is the recommended authentication scheme for new clients.

Project

string

header

required

Nebius project ID associated with the IAM token. Required together with IAMBearerAuth. Identifies the project context the request is scoped to.

Path Parameters

operationId

string<uuid>

required

The ID of the operation A UUID string

Example:

"12345678-9abc-baba-deda-0123456789ab"

spid

integer

required

Spawn id (1 = main process; ≥2 = exec'd children).

Required range: x >= 1

Response

Result of the requested subprocess.

Result of an instance execution

resources

object

Show child attributes

state

object

Show child attributes

stdout

object

Show child attributes

stderr

object

Show child attributes

Spawn an additional subprocess inside a running instance Kill one subprocess

⌘I

API Documentation

Inference and Training

Sandboxes

Result of one subprocess, reconstructed from its events

Authorizations

Path Parameters

Response