General APIs with JWT

Get nodes assigned to one of the caller's machine requests

Changed on

Endpoint to get all nodes a provider has assigned to one of the caller's machine requests.

get/machine-requests/{request_id}/executors

Request

  • Base URL: https://lium.io/api
  • URL: https://lium.io/api/machine-requests/{request_id}/executors
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

request_idstring uuid required

Response

List of nodes assigned to the machine request

idstring uuid
created_atstring date-time
updated_atstring date-time nullable
miner_hotkeystring required
miner_coldkeystring nullable
validator_hotkeystring required
executor_idstring uuid required
executor_ip_addressstring required
executor_checked_ipstring nullable
executor_ip_portstring required
executor_ssh_portstring nullable
activeboolean
machine_namestring nullable required
price_per_hournumber nullable
price_per_gpunumber nullable
gpu_countinteger nullable
available_gpu_countinteger nullable
gpu_uuid_anchorstring nullable

Smallest normalized GPU UUID on this machine; stable hardware anchor across hotkey/IP rotation

location_idstring nullable required
finished_jobsinteger
uptime_in_minutesinteger nullable
last_counted_job_batch_idstring nullable
previous_executor_idsstring[] nullable
collateral_depositedboolean nullable
rental_check_verified_statusstring nullable
verifiedboolean
verified_datestring date-time nullable
rental_verification_ssh_key_availableboolean nullable

Whether rental verification SSH key was available in the subnet SSH keys

reclaimedboolean
reclaimed_atstring date-time nullable
is_responsiveboolean nullable

Whether executor responds to health checks

unresponsive_sincestring date-time nullable

When the 5-minute ping last flipped is_responsive to False; None while responsive. The provider portal shows it as 'port unreachable since'

availability_errorsobject[]

Reachability checks the last cycle failed, each with what we saw (DAH-2748)

availability_checked_atstring date-time nullable

Scored-at time of the cycle that wrote availability_errors (DAH-2748)

pending_price_per_hournumber nullable

Pending price per hour that will be applied when price_change_effective_date is reached

price_change_effective_datestring date-time nullable

Date when the pending price change will become effective

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property //// to the response with the status