Lium · Schema

Executor

GPUMarketplaceArtificial IntelligenceComputeCloud

Properties

Name Type Description
id string
created_at string
updated_at object
miner_hotkey string
miner_coldkey object
validator_hotkey string
executor_id string
executor_ip_address string
executor_checked_ip object
executor_ip_port string
executor_ssh_port object
specs object
active boolean
machine_name object
price_per_hour object
price_per_gpu object
gpu_count object
gpu_uuid_anchor object Smallest normalized GPU UUID on this machine; stable hardware anchor across hotkey/IP rotation
location_id object
finished_jobs integer
uptime_in_minutes object
last_counted_job_batch_id object
previous_executor_ids object
reliability_reset_ids object
reliability_reset_at object
rental_check_verified_status object
verified boolean
verified_date object
rental_verification_ssh_key_available object Whether rental verification SSH key was available in the subnet SSH keys
reclaimed boolean
reclaimed_at object
deactivated_at object
is_responsive object Whether executor responds to health checks
unresponsive_since object When the 5-minute ping last flipped is_responsive to False; None while responsive. The provider portal shows it as 'port unreachable since'
availability_errors array Reachability checks the last cycle failed, each with what we saw (DAH-2748)
availability_checked_at object Scored-at time of the cycle that wrote availability_errors (DAH-2748)
idle_pay_blockers object Why the last validator cycle paid no idle pay: its incentive_reasons as {code, context}; NULL until a cycle reports them
idle_pay_blockers_at object Scored-at time of the cycle that wrote idle_pay_blockers
last_verified_at object received_at of the newest passed validator report about this node, set by a trigger on executor_validation_report; the listing reads it instead of the report table. None until a passed report
pending_price_per_hour object Pending price per hour that will be applied when price_change_effective_date is reached
price_change_effective_date object Date when the pending price change will become effective
View JSON Schema on GitHub

JSON Schema

lium-io-executor-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/lium-io/json-schema/lium-io-executor-schema.json",
  "title": "Executor",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/lium-io-openapi.json#/components/schemas/Executor",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "title": "Created At"
    },
    "updated_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Updated At"
    },
    "miner_hotkey": {
      "type": "string",
      "title": "Miner Hotkey"
    },
    "miner_coldkey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Miner Coldkey"
    },
    "validator_hotkey": {
      "type": "string",
      "title": "Validator Hotkey"
    },
    "executor_id": {
      "type": "string",
      "format": "uuid",
      "title": "Executor Id"
    },
    "executor_ip_address": {
      "type": "string",
      "title": "Executor Ip Address"
    },
    "executor_checked_ip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Executor Checked Ip"
    },
    "executor_ip_port": {
      "type": "string",
      "title": "Executor Ip Port"
    },
    "executor_ssh_port": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Executor Ssh Port"
    },
    "specs": {
      "$ref": "#/$defs/MachineSpecs"
    },
    "active": {
      "type": "boolean",
      "title": "Active",
      "default": true
    },
    "machine_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Machine Name"
    },
    "price_per_hour": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Per Hour"
    },
    "price_per_gpu": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Per Gpu"
    },
    "gpu_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Count"
    },
    "gpu_uuid_anchor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Uuid Anchor",
      "description": "Smallest normalized GPU UUID on this machine; stable hardware anchor across hotkey/IP rotation"
    },
    "location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Location Id"
    },
    "finished_jobs": {
      "type": "integer",
      "title": "Finished Jobs",
      "default": 0
    },
    "uptime_in_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Uptime In Minutes",
      "default": 0
    },
    "last_counted_job_batch_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Counted Job Batch Id"
    },
    "previous_executor_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Previous Executor Ids"
    },
    "reliability_reset_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reliability Reset Ids"
    },
    "reliability_reset_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reliability Reset At"
    },
    "rental_check_verified_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rental Check Verified Status",
      "default": "RentalCheckVerifiedStatus.RENTAL_CHECK_PENDING"
    },
    "verified": {
      "type": "boolean",
      "title": "Verified",
      "default": false
    },
    "verified_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Verified Date"
    },
    "rental_verification_ssh_key_available": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rental Verification Ssh Key Available",
      "description": "Whether rental verification SSH key was available in the subnet SSH keys"
    },
    "reclaimed": {
      "type": "boolean",
      "title": "Reclaimed",
      "default": false
    },
    "reclaimed_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reclaimed At"
    },
    "deactivated_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Deactivated At"
    },
    "is_responsive": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Responsive",
      "description": "Whether executor responds to health checks"
    },
    "unresponsive_since": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Unresponsive Since",
      "description": "When the 5-minute ping last flipped is_responsive to False; None while responsive. The provider portal shows it as 'port unreachable since'"
    },
    "availability_errors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array",
      "title": "Availability Errors",
      "description": "Reachability checks the last cycle failed, each with what we saw (DAH-2748)"
    },
    "availability_checked_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Availability Checked At",
      "description": "Scored-at time of the cycle that wrote availability_errors (DAH-2748)"
    },
    "idle_pay_blockers": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Idle Pay Blockers",
      "description": "Why the last validator cycle paid no idle pay: its incentive_reasons as {code, context}; NULL until a cycle reports them"
    },
    "idle_pay_blockers_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Idle Pay Blockers At",
      "description": "Scored-at time of the cycle that wrote idle_pay_blockers"
    },
    "last_verified_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Verified At",
      "description": "received_at of the newest passed validator report about this node, set by a trigger on executor_validation_report; the listing reads it instead of the report table. None until a passed report"
    },
    "pending_price_per_hour": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pending Price Per Hour",
      "description": "Pending price per hour that will be applied when price_change_effective_date is reached"
    },
    "price_change_effective_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Change Effective Date",
      "description": "Date when the pending price change will become effective"
    }
  },
  "type": "object",
  "required": [
    "miner_hotkey",
    "validator_hotkey",
    "executor_id",
    "executor_ip_address",
    "executor_ip_port",
    "specs",
    "machine_name",
    "location_id"
  ],
  "$defs": {
    "Checksums": {
      "properties": {
        "nvidia_smi": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvidia Smi"
        },
        "libnvidia_ml": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Libnvidia Ml"
        },
        "docker": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docker"
        }
      },
      "type": "object",
      "title": "Checksums"
    },
    "CpuSpec": {
      "properties": {
        "count": {
          "type": "integer",
          "title": "Count"
        },
        "model": {
          "type": "string",
          "title": "Model"
        },
        "utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Utilization"
        }
      },
      "type": "object",
      "required": [
        "count",
        "model"
      ],
      "title": "CpuSpec"
    },
    "DiskHealthSpec": {
      "properties": {
        "docker_root_dir": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docker Root Dir"
        },
        "read_only_mounts": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Read Only Mounts"
        },
        "write_probe": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Write Probe"
        },
        "write_probe_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Write Probe Error"
        }
      },
      "type": "object",
      "title": "DiskHealthSpec",
      "description": "DAH-2929: the validator's disk probe (lium-io DAH-2928, lium-io#1278), one cycle's readings.\n\nlium-io#1278 (15 Sep, value audit) sends four keys: ``docker_root_dir``, ``read_only_mounts``,\n``write_probe`` and ``write_probe_error``. Each is what the scrape measured that cycle; None or\nempty where it could not. The dmesg, sysfs, NVMe and SMART readers were cut from the probe before\nit shipped and are not declared here; a follow-up in lium-io that re-adds a reader declares its key\nhere in the same change.\n\nCONTRACT OBLIGATION (same as GpuMetrics): MachineSpecs validates with Pydantic's default\n``extra=\"ignore\"``, so a probe key the validator starts emitting that is not declared here is\nstripped on the upsert, not stored. Declare it here to keep it.\n\nOnly PUBLIC_DISK_HEALTH_FIELDS leave the API on the anonymous routes (``ExecutorForPodResponse`` serializes\nspecs through ``public_specs_projection``, ``BillingHistoryForMinerResponse`` serves only the GPU name and count;\n``ExecutorForProviderResponse`` declares the same two fields in ``PublicDiskHealth``, DAH-3462): the\nfree-text readings (docker root path, exception text) stay in the\nstored specs for operators. The machine request owner's ``GET /machine-requests/{id}/executors`` serves the\nrow's address fields (DAH-2554: ip, ssh port, coldkey by design) and the projected specs (DAH-4180)."
    },
    "DiskPressureSpec": {
      "properties": {
        "syncfs_seconds": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Syncfs Seconds"
        },
        "syncfs_timed_out": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Syncfs Timed Out"
        },
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "mb_per_s": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Mb Per S"
        },
        "util_percent": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Util Percent"
        },
        "await_ms": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Await Ms"
        },
        "dirty_mb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Dirty Mb"
        },
        "writeback_mb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Writeback Mb"
        },
        "psi_io_full_avg10": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Psi Io Full Avg10"
        },
        "pressure": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pressure"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reason"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Error"
        }
      },
      "type": "object",
      "title": "DiskPressureSpec",
      "description": "What the validator read on the host right before it started its port-check container.\n\n`syncfs_seconds` is how long `sync -f` on the Docker root took (capped at the validator's poll\nbudget, then `syncfs_timed_out`): the wait every `docker run` pays while a tenant's dirty pages\nsit on that filesystem. The disk and memory fields are telemetry around it. Every field is None\nwhen that part could not be read; `error` says why the whole reading is missing."
    },
    "DockerSpec": {
      "properties": {
        "version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version"
        },
        "container_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Container Id"
        },
        "containers": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Containers"
        },
        "host_cpu_percent": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Host Cpu Percent"
        }
      },
      "type": "object",
      "title": "DockerSpec"
    },
    "GpuActivitySpec": {
      "properties": {
        "index": {
          "type": "integer",
          "title": "Index"
        },
        "uuid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Uuid"
        },
        "util_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Util Pct"
        },
        "vram_used_mb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Used Mb"
        },
        "vram_total_mb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Total Mb"
        },
        "no_pod": {
          "type": "boolean",
          "title": "No Pod"
        }
      },
      "type": "object",
      "required": [
        "index",
        "no_pod"
      ],
      "title": "GpuActivitySpec",
      "description": "One GPU's load at scrape time next to whether a rental held it — a rule input, not a verdict.\n\nDerived by the backend on every validator report (`services/gpu_activity.py`, called from\n`worker.save_executor_into_db`), never sent by the validator. `util_pct` and `vram_used_mb` are\n`gpu.details[].gpu_utilization` / `memory_used_mb` of the same report; `no_pod` is \"no\n`executor_gpu` row with this `uuid` has a `pod_id`\" at save time — the backend's own record of\nwhich GPU a rental holds, which the scrape cannot see (its `gpu_processes` is read from inside\nthe executor container, so a process on the host is invisible to it: rel-box-34 case 11, executor\n252f0496, 14-100 % utilisation for hours with no pod and `gpu_processes` `[]` in 672/672 snapshots).\n\n`no_pod` says nothing about a default job (filler): a filler holds no `executor_gpu.pod_id`, so a\nGPU it uses reads `no_pod: true` with load. A consumer excludes fillers through\n`specs.docker.containers` (`filler_` prefix), as the loop's host-load detector already does."
    },
    "GpuMetrics": {
      "properties": {
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "cc": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cc"
        },
        "sm_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sm Count"
        },
        "clock_mhz": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Clock Mhz"
        },
        "vram_gb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Gb"
        },
        "n": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "N"
        },
        "fp32_tflops": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Tflops"
        },
        "fp32_median_tflops": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Median Tflops"
        },
        "fp32_cov_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Cov Pct"
        }
      },
      "type": "object",
      "title": "GpuMetrics",
      "description": "FP32 throughput metrics from libdmcompverify.so getMetrics() (device-0 representative).\n\nAll fields are optional: the .so may emit a subset, and the whole object is absent\nwhen TFLOPS benchmarking is disabled or fails (fail-safe).\n\nCONTRACT OBLIGATION: this model mirrors getMetrics() output. Because MachineSpecs has\n`extra` unset (Pydantic defaults to ignore -> undeclared keys are stripped on\nvalidation), any NEW field that libdmcompverify.so's getMetrics() starts emitting MUST\nbe added here too, or it is silently dropped on coercion. Adding the field here is the\ndocumented way to surface it; failing to do so is a silent-strip data-loss bug, not a\ncrash."
    },
    "GpuSpec": {
      "properties": {
        "count": {
          "type": "integer",
          "title": "Count"
        },
        "driver": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Driver"
        },
        "cuda_driver": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cuda Driver"
        },
        "details": {
          "items": {
            "$ref": "#/$defs/ReportedGpuDetail"
          },
          "type": "array",
          "title": "Details"
        }
      },
      "type": "object",
      "required": [
        "count",
        "details"
      ],
      "title": "GpuSpec"
    },
    "HardDiskSpec": {
      "properties": {
        "total": {
          "type": "integer",
          "title": "Total"
        },
        "used": {
          "type": "integer",
          "title": "Used"
        },
        "free": {
          "type": "integer",
          "title": "Free"
        },
        "utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Utilization"
        },
        "images": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Images"
        },
        "containers": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Containers"
        },
        "volumes": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Volumes"
        },
        "disk_type": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "nvme",
                "ssd",
                "hdd",
                "unknown"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Disk Type"
        },
        "engy_cache_used_gb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Engy Cache Used Gb"
        },
        "engy_cache_released_gb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Engy Cache Released Gb"
        },
        "by_volume": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "By Volume"
        },
        "by_container": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "By Container"
        }
      },
      "type": "object",
      "required": [
        "total",
        "used",
        "free"
      ],
      "title": "HardDiskSpec"
    },
    "InfinibandPortSpec": {
      "properties": {
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "port": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Port"
        },
        "node_guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Node Guid"
        },
        "sys_image_guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sys Image Guid"
        },
        "link_layer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Link Layer"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "State"
        },
        "phys_state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Phys State"
        },
        "rate": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Rate"
        },
        "lid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lid"
        },
        "sm_lid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sm Lid"
        },
        "pkey": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pkey"
        },
        "gids": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gids"
        },
        "driver": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Driver"
        }
      },
      "type": "object",
      "title": "InfinibandPortSpec",
      "description": "One RDMA port as the executor's kernel reports it (DAH-2571).\n\n`link_layer` is the ONLY safe way to tell InfiniBand from RoCE: mlx5 reports `lid` 0x0 on an\nEthernet port but Intel irdma reports 0x1, measured on prod 2026-08-05.\n\nWhat identifies a fabric: on InfiniBand, `sm_lid` with the LID set — a host running its own\nsubnet manager reports `sm_lid` 0x1 pointing at its own port, so it is a one-host subnet, while\nan external switch-side SM shows up as something else (0xe on the one real multi-node fabric in\nthe fleet). On RoCE it is the IPv4-mapped entry of `gids` — find it by the\n`0000:0000:0000:0000:0000:ffff:` prefix, never by index: mlx5 puts it at 2-3, Intel irdma at 1.\nThe GID prefix is NOT usable — every prod port carries the default `fe80::`.\n\nThose IPv4-mapped addresses are private (172.16/10.x observed on prod), so they identify a\nsegment only WITHIN one provider — two providers can hand out the same one. Pair on them only\ntogether with something provider-scoped.\n\n`rate` is meaningful only while `state` is ACTIVE; on a DOWN port the driver fills in a\nplaceholder rather than the card's real capability."
    },
    "InterconnectSpec": {
      "properties": {
        "gpu_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Count"
        },
        "gpu_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Pairs"
        },
        "nvlink": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink"
        },
        "nvlink_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Links"
        },
        "nvlink_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Pairs"
        },
        "nvlink_active_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Active Links"
        },
        "pcie_class": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pcie Class"
        },
        "p2p": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P"
        },
        "p2p_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Pairs"
        },
        "p2p_ok_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Ok Pairs"
        },
        "matrix": {
          "anyOf": [
            {
              "items": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Matrix"
        }
      },
      "type": "object",
      "title": "InterconnectSpec",
      "description": "How the G

# --- truncated at 32 KB (53 KB total) ---
# Full source: https://artifacts.apis.io/lium-io/json-schema/lium-io-executor-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/lium-io-executor"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.