# NoctHost API

**Canonical:** https://apis.io/apis/nocthost/nocthost-api/  
**Provider:** NoctHost — https://apis.io/providers/nocthost/  
**Base URL:** https://api.nocthost.com  
**Documentation:** https://nocthost.com/docs/api

NoctHost API is one of 2 APIs that [NoctHost](https://apis.io/providers/nocthost/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

NoctHost API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-11-02); not the provider's own document.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| POST | `/auth/login` | Get a fresh access token (expires in 15 minutes). |
| GET | `/auth/me` | Whoami: id, email and current balance. |
| POST | `/auth/register` | Create an account. Email + password is all that is needed. |
| GET | `/backups` | List your backups (full disk snapshots, kept 7 days). |
| POST | `/backups` | Back up a server. Async: snapshot takes minutes, PENDING -> AVAILABLE. |
| DELETE | `/backups/{id}` | Delete a backup before its 7-day expiry. |
| POST | `/backups/{id}/restore` | Restore an AVAILABLE backup onto a new server (gets a new IP). |
| GET | `/billing` | Balance and total hourly spend across active servers. |
| DELETE | `/servers` | Destroy a server. Billing stops the same hour. |
| GET | `/servers` | List all non-destroyed servers. |
| POST | `/servers` | POST /servers |
| DELETE | `/servers/{id}` | Destroy a server. Billing stops the same hour. |
| GET | `/servers/{id}` | One server. Poll this every ~5s after a deploy. |
| POST | `/servers/{id}/reboot` | Reboot a running server. |
| POST | `/servers/{id}/root-password` | Set a new root password without erasing the disk. |
| POST | `/servers/{id}/start` | Power a STOPPED server back on. |
| POST | `/servers/{id}/stop` | Power off a server. STOPPED is still billed while it exists. |
| POST | `/servers/bulk` | Deploy up to 10 servers in one call. Labels get -1..-N suffixes. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/nocthost/openapi/_ae-authored/nocthost-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-get-backups-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-post-backups-id-restore-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-post-servers-id-root-password-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-post-servers-bulk-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-post-servers-id-start-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/nocthost/json-schema/nocthost-post-backups-id-restore-response-schema.json

## Other NoctHost APIs (1)

- [NoctHost API](https://apis.io/apis/nocthost/nocthost-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nocthost/nocthost-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nocthost/.