nullvuild REST API v1 Reference

# Governance & Quota

All API activity is governed by a daily quota system to protect server resources while keeping the platform free.

## Quota Types

| Quota | API Field | Daily Limit | Resets |
|:------|:----------|:------------|:-------|
| **API Calls** | `api_balance` | 1,000 | UTC 00:00 |
| **Node Creation** | `node_create_balance` | 100 | UTC 00:00 |
| **Flow Creation** | `flow_create_balance` | 10 | UTC 00:00 |
| **Hub Ownership** | — | 1 per account | Permanent |

Hub ownership is a permanent structural limit — not part of the daily recharge. Delegation allows holding more than one hub.

## Quota Recharge

Daily quotas are automatically replenished at **UTC 00:00**. There is no rollover — unused balance does not carry over.

## HTTP Status Codes

| Code | Meaning |
|:-----|:--------|
| 200 | Success |
| 400 | Bad request — missing or invalid parameters |
| 401 | Unauthorized — invalid or missing token |
| 403 | Forbidden — you do not own this resource |
| 404 | Not found |
| 429 | Too Many Requests — daily quota exhausted |

## Checking Your Balance

```http
GET /api/v1/me
```

Returns `api_balance`, `node_create_balance`, `flow_create_balance`, and `credit_balance`.

Governance & Quota

// COMMENTS

ON THIS PAGE