1node API

1Node API Reference

This document defines the HTTP REST API equivalent of the 1node CLI commands. Each CLI command is mapped to a REST endpoint, with method, path, parameters, and sample request/response.

All endpoints require a Bearer token in the Authorization header:

Authorization: Bearer <1NODE_API_TOKEN>

Authentication Examples with curl

• Deploy Job

curl -X POST https://api.1node.run/v1/deploy \
  -H "Authorization: Bearer $1NODE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":"akash",
    "jobDescriptor":{ /* ... job JSON ... */ }
}'

• Stream Logs

curl https://api.1node.run/v1/logs/akash1xyz?follow=true \
  -H "Authorization: Bearer $1NODE_API_TOKEN"

• List Providers

curl "https://api.1node.run/v1/providers?gpu=A100&region=us-west" \
  -H "Authorization: Bearer $1NODE_API_TOKEN"