Compute API

Full reference for creating, listing, managing, and destroying compute instances via the API.

Endpoints

Base URL: https://api.prvtech.com/v1. Requires a valid API key — see Authentication.

Overview

Method

Endpoint

Description

Scope

GET

/instances

List all instances

compute:read

POST

/instances

Create instance

compute:write

GET

/instances/{id}

Get details

compute:read

POST

/instances/{id}/actions

Perform action

compute:write

DELETE

/instances/{id}

Destroy instance

compute:write

Create Fields

Field

Type

Required

Description

region

string

Yes

Region code (see Instances)

plan

string

Yes

Plan ID

image

string

Yes

OS image ID

hostname

string

No

Server hostname

ssh_keys

array

No

SSH key IDs

user_data

string

No

Cloud-init script

vpc_id

string

No

See Networking

project_id

string

No

See Projects

Actions

Action

Description

Downtime

start

Power on

No

stop

Shut down

Yes

reboot

Hard reboot

Yes

reinstall

Reinstall OS

Yes

resize

Change plan

Yes

snapshot

Create snapshot

No

DELETE /instances/{id} destroys the instance. Attached volumes are detached but kept.

On this page