Agent Nodes
Register agent nodes and maintain heartbeat connections.
Agent Nodes
Register agent nodes and maintain heartbeat connections.
POST
/v1/nodes/registerAPI KeyRegister or update an agent node
POST
/v1/nodes/:id/heartbeatAPI KeySend heartbeat (15min active window)
Nodes inactive for 15+ minutes are freed. Limits: Community 3, Pro 10, Team 50, Enterprise 500.
Register node
POST /v1/nodes/register
Authorization: Bearer navil_live_abc123...
{
"node_id": "agent-prod-01",
"hostname": "worker.acme.io",
"version": "1.2.0"
}Node Lifecycle
Agent nodes follow a simple lifecycle:
1
Register
Call POST /v1/nodes/register with node ID, hostname, and version. The node slot is reserved.
2
Heartbeat
Send heartbeats every 5-10 minutes via POST /v1/nodes/:id/heartbeat. The active window is 15 minutes.
3
Expiry
If no heartbeat is received for 15 minutes, the node slot is automatically freed for reuse.
Tier Limits
| Tier | Max Nodes |
|---|---|
| Community | 3 |
| Pro | 10 |
| Team | 50 |
| Enterprise | 500 |