# 1node API

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"
```