# REST API Reference

> Explore the NOVA Cloud public REST API.

The NOVA Cloud public API (`v0`) lets you register and manage NOVA OS instances
and virtual instances programmatically. It is served under the `/api/v0` base
path and authenticated with a bearer JWT from your session.

This page renders an interactive API reference on the website.

The full API spec is available as a YAML file: /specs/nova-cloud/openapi.yaml

### Configuration

| Method | Path | Summary |
| - | - | - |
| **GET** | `/config/cloud` | Get Cloud Configuration |

### Cells

| Method | Path | Summary |
| - | - | - |
| **GET** | `/cells` | List Registered Cells |

### Users

| Method | Path | Summary |
| - | - | - |
| **GET** | `/users` | List Users |

### Instance Registration

| Method | Path | Summary |
| - | - | - |
| **GET** | `/instances` | List Registered Instances |
| **POST** | `/instances/register-with-token` | Register Instance With Token |
| **POST** | `/instances/registration-tokens` | Create Registration Token |

### Virtual Instances

| Method | Path | Summary |
| - | - | - |
| **GET** | `/virtual/instances` | List Virtual Instances |
| **POST** | `/virtual/instances` | Create Virtual Instance |
| **DELETE** | `/virtual/instances/{instance_id}` | Delete Virtual Instance |
| **PUT** | `/virtual/instances/{instance_id}/state` | Start or Stop Virtual Instance |
| **PUT** | `/virtual/instances/{instance_id}/lifetime` | Extend Virtual Instance Lifetime |