# HTTP API

> The Nodus REST API, Kubernetes-style resources under /apis/nodus.dev, generated from the Go types.

Source: https://nodus-platform-site.pages.dev/docs/reference/api/
Build revision: 211ad9f836655b1c3a2668c4693e442471f28614

Nodus serves every resource at a Kubernetes-style path, so `kubectl`, `client-go` and the generated clients all work against it:

```text
GET    /apis/nodus.dev/v1/namespaces/{project}/jobs
POST   /apis/nodus.dev/v1/namespaces/{project}/jobs
GET    /apis/nodus.dev/v1/namespaces/{project}/jobs/{name}
GET    /apis/nodus.dev/v1/namespaces/{project}/jobs?watch=true
```

Authenticate with an API key as a bearer token (`Authorization: Bearer nodus_sk_…`). Lists page with `limit` and `continue`, writes accept an `Idempotency-Key` header, and `?dryRun=All` validates a create and returns its estimate without charging anything. Errors are described in [Error codes](https://nodus-platform-site.pages.dev/docs/reference/errors/).

The per-operation reference in the sidebar is generated from the OpenAPI document, which is also served at [`/docs/openapi.json`](https://nodus-platform-site.pages.dev/docs/openapi.json).