logo
API docs by Redocly

Simplepod.ai API (latest)

Download OpenAPI specification:

REST API

Overview

The API is based on REST principles. It supports GET, POST, PUT, PATCH and DELETE requests.

📢 Join Our Community on Discord

We’ve set up a dedicated Discord channel for developers working with our API.
It’s the best place to:

  • Ask questions and get support from the team
  • Share feedback and feature requests
  • Connect with other developers building on the API

👉 Click here to join the Discord channel

Base URI

All URLs referenced in the documentation have the following base: https://api.simplepod.ai

Postman Collection

You can fork postman collection to your workspace and test the API via this link:

Run In Postman

Authentication

apiKey

To call api methods you must provide api key.
The api key is listed in Account Settings on Subaccouts tab.
Each api key is assigned to subaccount and its permissions.

Security Scheme Type: API Key
Header parameter name: X-AUTH-TOKEN

Rent Docker

Find Instances

Queries the GPU marketplace for available Docker rental hosts. Each variant represents a GPU configuration tier. The returned instanceMarket IRI is used as the reference when creating a new rental.

Authorizations:
apiKey
query Parameters
order[gpuCount]
string
Enum: "asc" "desc"
Example: order[gpuCount]=desc

Order by GPUs

order[sla]
string
Enum: "asc" "desc"
Example: order[sla]=desc

Order by availability

order[pricePerGpu]
string
Enum: "asc" "desc"
Example: order[pricePerGpu]=desc

Order by price

order[sysDlp]
string
Enum: "asc" "desc"
Example: order[sysDlp]=desc

Order by DLPerf

order[pricePerDlp]
string
Enum: "asc" "desc"
Example: order[pricePerDlp]=desc

Order by DLPerf/$/h

order[gpuTFlops]
string
Enum: "asc" "desc"
Example: order[gpuTFlops]=desc

Order by TFLOPs

order[pricePerTFlops]
string
Enum: "asc" "desc"
Example: order[pricePerTFlops]=desc

Order by TFLOPs/$/h

region
string
Enum: "World" "Asia" "Europe" "North America" "Oceania" "South America"
Example: region=World

Filter by region

downloadSpeedtest[gte]
integer
Example: downloadSpeedtest[gte]=1

Filter by download speedtest (greater or equal than): value from 1 to 16384

downloadSpeedtest[lte]
integer
Example: downloadSpeedtest[lte]=16384

Filter by download speedtest (lower or equals than): value from 1 to 16384

uploadSpeedtest[gte]
integer
Example: uploadSpeedtest[gte]=1

Filter by upload speedtest (greater or equal than): value from 1 to 16384

uploadSpeedtest[lte]
integer
Example: uploadSpeedtest[lte]=16384

Filter by upload speedtest (lower or equals than): value from 1 to 16384

diskSize[gte]
integer
Example: diskSize[gte]=32

Filter by disk space GB (greater or equal than): value from 32 to 65536

diskSize[lte]
integer
Example: diskSize[lte]=65536

Filter by disk space GB (lower or equals than): value from 32 to 65536

cpuCoreCount[gte]
integer
Example: cpuCoreCount[gte]=1

Filter by CPU cores (greater or equal than): value from 1 to 512

cpuCoreCount[lte]
integer
Example: cpuCoreCount[lte]=512

Filter by CPU cores (lower or equals than): value from 1 to 512

systemMemory[gte]
integer
Example: systemMemory[gte]=4096

Filter by system memory MB (greater or equal than): value from 4096 to 8388608

systemMemory[lte]
integer
Example: systemMemory[lte]=8388608

Filter by system memory MB (lower or equals than): value from 4096 to 8388608

diskSpeedWrite[gte]
integer
Example: diskSpeedWrite[gte]=1

Filter by disk speed MB/s (greater or equal than): value from 1 to 131072

diskSpeedWrite[lte]
integer
Example: diskSpeedWrite[lte]=131072

Filter by disk speed MB/s (lower or equals than): value from 1 to 131072

gpuModel
string
Enum: "Any" "RTX 4090"
Example: gpuModel=Any

Filter by GPU Model

gpuCount[gte]
integer
Example: gpuCount[gte]=1

Filter by GPU count (greater or equal than): value from 1 to 16

gpuCount[lte]
integer
Example: gpuCount[lte]=16

Filter by GPU count (lower or equals than): value from 1 to 16

gpuTFlops[gte]
integer
Example: gpuTFlops[gte]=1

Filter by TFLOPS total (greater or equal than): value from 1 to 256

gpuTFlops[lte]
integer
Example: gpuTFlops[lte]=256

Filter by TFLOPS total (lower or equals than): value from 1 to 256

gpuMemorySize[gte]
integer
Example: gpuMemorySize[gte]=8192

Filter by GPU Memory size MB (greater or equal than): value from 8192 to 524288

gpuMemorySize[lte]
integer
Example: gpuMemorySize[lte]=524288

Filter by GPU Memory size MB (lower or equals than): value from 8192 to 524288

gpuPcieBandwidth[gte]
integer
Example: gpuPcieBandwidth[gte]=1

Filter by PCI-E bandwidth GBit/s (greater or equal than): value from 1 to 128

gpuPcieBandwidth[lte]
integer
Example: gpuPcieBandwidth[lte]=128

Filter by PCI-E bandwidth GBit/s (lower or equals than): value from 1 to 128

gpuDriverVer
string
Example: gpuDriverVer=1

Filter by Driver version

gpuDriverVerComparisonOperator
string
Enum: "=" "<=" ">="
Example: gpuDriverVerComparisonOperator==

Filter by Driver version - comparison method

gpuCudaVer
string
Example: gpuCudaVer=1

Filter by CUDA version

gpuCudaVerOperator
string
Enum: "=" "<=" ">="
Example: gpuCudaVerOperator==

Filter by CUDA version - comparison method

rentalStatus
string
Enum: "Any" "active" "inactive"
Example: rentalStatus=Any

Filter by Rental status:
Any
active - Available for rent
inactive - Rented

sla[gte]
integer
Example: sla[gte]=1

Filter by uptime % (greater or equal than): value from 1 to 100

sla[lte]
integer
Example: sla[lte]=100

Filter by uptime % (lower or equals than): value from 1 to 100

rentalTimeMin[gte]
integer
Example: rentalTimeMin[gte]=1

Filter by min duration h (greater or equal than): value from 1 to 8600

rentalTimeMin[lte]
integer
Example: rentalTimeMin[lte]=8600

Filter by min duration h (lower or equals than): value from 1 to 8600

pricePerGpu[gte]
integer

Filter by price $/hour (greater or equal than): value from 0 to 5

pricePerGpu[lte]
integer
Example: pricePerGpu[lte]=5

Filter by price $/hour (lower or equals than): value from 0 to 5

pricePerTFlops[gte]
integer

Filter by price TFLOPS/$/hour (greater or equal than): value from 0 to 200

pricePerTFlops[lte]
integer
Example: pricePerTFlops[lte]=200

Filter by price TFLOPS/$/hour (lower or equals than): value from 0 to 200

pricePerDlp[gte]
integer

Filter by price DLP/$/hour (greater or equal than): value from 0 to 200

pricePerDlp[lte]
integer
Example: pricePerDlp[lte]=200

Filter by price DLP/$/hour (lower or equals than): value from 0 to 200

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/market/list?rentalStatus=active' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Global templates

Returns the catalog of publicly available Docker image templates. These are pre-configured templates (e.g., Ubuntu, PyTorch) with predefined disk size, exposed ports, start scripts, and environment variables. Used as the basis for creating private template groups or directly when renting a Docker instance.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/global-templates/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Global template details

Returns full details of a global Docker image template including image configuration, start script, ARG/ENV variables, and feature options (SSH server, Jupyter).

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Template ID

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/global-templates/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "id": 0,
  • "imageName": "string",
  • "categoryName": "string",
  • "defaultTag": "string",
  • "diskSize": 0,
  • "exposePorts": "string",
  • "startScript": "string",
  • "argOptions": [
    ],
  • "envVariables": [
    ],
  • "notes": "string",
  • "host": "string",
  • "username": "string",
  • "password": "string",
  • "isPublic": true,
  • "isPasswordProtected": true,
  • "isRunSshServerOn": true,
  • "isRunJupyterOn": true
}

Private Template Groups

Returns the authenticated user's private Docker image template groups. These are customized versions of global templates or entirely custom Docker images with private registry credentials. Each template group defines the container configuration (image, tag, disk size, ports, SSH, Jupyter) used when renting instances.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/templates/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Add Private Template Group

Creates a new private Docker image template group. Allows specifying a custom Docker image with optional private registry authentication (host, username, password), disk size allocation, exposed ports, start script, ARG options, ENV variables, and feature toggles (SSH server, Jupyter). The template is private to the authenticated user and can be used when renting Docker instances.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
host
string

Host of private docker hub

username
string

Username of private docker hub

password
string

password of private docker hub

name
string

Name of template

imageName
string

Name of image

categoryName
number

Category of image

defaultTag
number

Tag of image

diskSize
integer

Size of instances created with this template

exposePorts
string

Provide comma separated port numbers

startScript
string

Autostart bash script

argOptions
string

Docker image ARG

envVariables
Array of any

ENV variables

notes
string

Notes

isPasswordProtected
boolean

Custom repository server

isRunSshServerOn
boolean

SSH server

isRunJupyterOn
boolean

Jupyter Notebook

Responses

Request samples

Content type
application/json
{
  • "host": "https://hub.docker.com",
  • "username": "simplepod",
  • "password": "password",
  • "name": "ubuntu",
  • "imageName": "ubuntu",
  • "categoryName": "ubuntu",
  • "defaultTag": "latest",
  • "diskSize": 32,
  • "exposePorts": "22,80,443",
  • "startScript": "string",
  • "argOptions": "string",
  • "envVariables": "[ { \"name\": \"ENV1\", \"value\": \"VALUE1\" } ]",
  • "notes": "string",
  • "isPasswordProtected": false,
  • "isRunSshServerOn": true,
  • "isRunJupyterOn": true
}

Response samples

Content type
application/json
{ }

Private Template Group details

Returns full details of a private template group including Docker registry host, credentials, image configuration, start script, ARG/ENV variables, and feature flags. Only accessible by the template owner.

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Template ID

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/templates/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "id": 0,
  • "imageName": "string",
  • "categoryName": "string",
  • "defaultTag": "string",
  • "diskSize": 0,
  • "exposePorts": "string",
  • "startScript": "string",
  • "argOptions": [
    ],
  • "envVariables": [
    ],
  • "notes": "string",
  • "host": "string",
  • "username": "string",
  • "password": "string",
  • "isPublic": true,
  • "isPasswordProtected": true,
  • "isRunSshServerOn": true,
  • "isRunJupyterOn": true
}

Update Private Template Group

Updates a private Docker image template group's configuration. Can modify the Docker registry host and credentials, image name and tag, disk size, exposed ports, start script, ARG/ENV variables, notes, and feature toggles (password protection, SSH server, Jupyter). Changes apply to future instance creations using this template.

Authorizations:
apiKey
path Parameters
id
required
integer
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
host
string

Host of private docker hub

username
string

Username of private docker hub

password
string

password of private docker hub

name
string

Name of template

imageName
string

Name of image

categoryName
number

Category of image

defaultTag
number

Tag of image

diskSize
integer

Size of instances created with this template

exposePorts
string

Provide comma separated port numbers

startScript
number

Autostart bash script

argOptions
string

Docker image ARG

envVariables
Array of any

ENV variables

notes
string

Notes

isPasswordProtected
boolean

Custom repository server

isRunSshServerOn
boolean

SSH server

isRunJupyterOn
boolean

Jupyter Notebook

Responses

Request samples

Content type
application/json
{
  • "host": "https://hub.docker.com",
  • "username": "simplepod",
  • "password": "password",
  • "name": "ubuntu",
  • "imageName": "ubuntu",
  • "categoryName": "ubuntu",
  • "defaultTag": "latest",
  • "diskSize": 32,
  • "exposePorts": "22,80,443",
  • "startScript": 0,
  • "argOptions": "string",
  • "envVariables": "[ { \"name\": \"ENV1\", \"value\": \"VALUE1\" } ]",
  • "notes": "string",
  • "isPasswordProtected": false,
  • "isRunSshServerOn": true,
  • "isRunJupyterOn": true
}

Response samples

Content type
application/json
{ }

Delete Private Template Group

Deletes a private Docker image template group. Only the template owner can delete it.

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Instance ID

Responses

Request samples 

curl --location --request DELETE 'https://api.simplepod.ai/instances/templates/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{}

Rent Instance

Creates a new Docker rental instance on the selected host. Validates balance and availability. Supports batch creation via numOfInstances.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
gpuCount
integer

Number of GPUs

instanceMarket
string

IRI of instance market

instanceTemplate
string

IRI of template group

startScript
string

Autostart bash script

envVariables
Array of any

ENV variables

Responses

Request samples

Content type
application/json
{
  • "gpuCount": 1,
  • "instanceMarket": "/instances/market/1",
  • "instanceTemplate": "/instances/templates/38",
  • "startScript": "string",
  • "envVariables": "[ { \"name\": \"ENV1\", \"value\": \"VALUE1\" } ]"
}

Response samples

Content type
application/json
{ }

Instances list

Returns the authenticated user's rental instances (both Docker and VPS). Each instance includes real-time stats such as CPU/memory/disk usage and process uptime. Supports pagination and search filtering by name or template.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Instance details

Returns detailed information about a specific rental instance, including real-time GPU telemetry and recent errors and warnings.

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Instance ID

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "id": 0,
  • "hashId": "string",
  • "name": "string",
  • "notes": "string",
  • "gpuModel": "string",
  • "gpuMemorySize": 0,
  • "gpuCount": 0,
  • "cpuCoreCount": 0,
  • "systemMemory": 0,
  • "diskSize": 0,
  • "diskSizeMax": 0,
  • "status": "created",
  • "duration": 0,
  • "rentalType": "demand",
  • "pricePerGpu": 0,
  • "pricePerDiskSize": 0,
  • "priceAutoRenewMax": 0,
  • "expiresAt": "2025-05-10T13:59:01+02:00",
  • "autoRenewAt": "2025-05-10T13:59:01+02:00",
  • "isAutoRenewOn": true,
  • "instanceTemplate": {
    },
  • "ports": {
    },
  • "cpuUsage": 0,
  • "memUsage": 0,
  • "diskUsage": 0,
  • "processUptime": 0,
  • "console": "string",
  • "consoleSystem": "string"
}

Update Instance

Updates a Docker rental instance's settings. Can modify auto-renew, max price, name, notes, start script, env variables, and Docker image template. For VPS instances, disk size can only be increased.

Authorizations:
apiKey
path Parameters
id
required
integer
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
isAutoRenewOn
boolean

Set Allow Auto Renew

priceAutoRenewMax
number

Set max price for auto renew

notes
string

Set notes

instanceTemplate
string

IRI of template

name
string

Set name of instance

startScript
string

Autostart bash script

envVariables
Array of any

ENV variables

Responses

Request samples

Content type
application/json
{
  • "isAutoRenewOn": true,
  • "priceAutoRenewMax": 1,
  • "notes": "notes here",
  • "instanceTemplate": "/instances/templates/29",
  • "name": "sensible_pangolin",
  • "startScript": "string",
  • "envVariables": [
    ]
}

Response samples

Content type
application/json
{ }

Delete Instance

Deletes a rental instance (Docker or VPS).

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Instance ID

Responses

Request samples 

curl --location --request DELETE 'https://api.simplepod.ai/instances/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{}

Reboot Instance

Triggers a reboot for one or more Docker instances. Accepts an array of instance IDs as a bulk operation.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
instanceIds
Array of any

Provide Instance IDs

Responses

Request samples

Content type
application/merge-patch+json
{
  • "instanceIds": [
    ]
}

Response samples

Content type
application/json
{ }

Rent VPS

VPS list

Queries the GPU marketplace for available VPS rental hosts. Each variant represents a GPU configuration tier. The returned instanceMarket IRI is used when creating a new VPS rental and in resume rental requests.

Authorizations:
apiKey
query Parameters
order[gpuCount]
string
Enum: "asc" "desc"
Example: order[gpuCount]=desc

Order by GPUs

order[sla]
string
Enum: "asc" "desc"
Example: order[sla]=desc

Order by availability

order[pricePerGpu]
string
Enum: "asc" "desc"
Example: order[pricePerGpu]=desc

Order by price

region
string
Enum: "World" "Asia" "Europe" "North America" "Oceania" "South America"
Example: region=World

Filter by region

gpuModel
string
Enum: "Any" "RTX 4090"
Example: gpuModel=Any

Filter by GPU Model

gpuCount[gte]
integer
Example: gpuCount[gte]=1

Filter by GPU count (greater or equal than): value from 1 to 16

gpuCount[lte]
integer
Example: gpuCount[lte]=16

Filter by GPU count (lower or equals than): value from 1 to 16

rentalStatus
string
Enum: "Any" "active" "inactive"
Example: rentalStatus=Any

Filter by Rental status:
Any
active - Available for rent
inactive - Rented

sla[gte]
integer
Example: sla[gte]=1

Filter by uptime % (greater or equal than): value from 1 to 100

sla[lte]
integer
Example: sla[lte]=100

Filter by uptime % (lower or equals than): value from 1 to 100

pricePerGpu[gte]
integer

Filter by price $/hour (greater or equal than): value from 0 to 5

pricePerGpu[lte]
integer
Example: pricePerGpu[lte]=5

Filter by price $/hour (lower or equals than): value from 0 to 5

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/market/list?mode=vm&rentalStatus=active' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Images List

Returns available VPS operating system images (e.g., Ubuntu, Windows). Each image specifies a minimum disk size requirement (diskSizeMin) that the selected host must meet. The image IRI is required when renting a new VPS instance.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/templates/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Rent VPS

Creates a new VPS rental instance. Validates balance and availability before proceeding.

Linux-based images: Provide userSshKey with an IRI of a saved SSH key or a raw public SSH key. If a raw key is provided, it is saved automatically. Optionally set userSshKeyName to name the saved key.

Windows-based images: Provide password instead of an SSH key.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
instanceMarket
string

IRI of instance market

instanceVmImage
string

IRI of VM image

userSshKey
string

IRI of user SSH key or raw public SSH key (required for Linux images)

userSshKeyName
string

Name to save for the public SSH key (optional, used with Linux images)

password
string

Password for the VPS instance (required for Windows images)

Responses

Request samples

Content type
application/json
{
  • "instanceMarket": "/instances/market/1",
  • "instanceVmImage": "/instances/images/29",
  • "userSshKey": "/user-ssh-keys/1",
  • "userSshKeyName": "My SSH Key",
  • "password": "MySecurePassword123"
}

Response samples

Content type
application/json
{ }

Resume VPS

Resumes a previously paused VPS instance on a new host. The instance retains its configuration, SSH key, and IP address. Can be referenced by instance IRI or support ID (e.g., 'V_abcd'). Validates balance and host availability before proceeding.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/json
Request Body schema: application/json
instanceMarket
string

IRI of instance market

instance
string

IRI of paused instance or support ID

Responses

Request samples

Content type
application/json
{
  • "instanceMarket": "/instances/market/1",
  • "instance": "V_abcd"
}

Response samples

Content type
application/json
{ }

Instances list

Returns the authenticated user's rental instances (both Docker and VPS). Each instance includes real-time stats such as CPU/memory/disk usage and process uptime. Supports pagination and search filtering by name or template.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Instance details

Returns detailed information about a specific rental instance, including real-time GPU telemetry and recent errors and warnings.

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Instance ID

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{
  • "id": 0,
  • "hashId": "string",
  • "name": "string",
  • "notes": "string",
  • "gpuModel": "string",
  • "gpuMemorySize": 0,
  • "gpuCount": 0,
  • "cpuCoreCount": 0,
  • "systemMemory": 0,
  • "diskSize": 0,
  • "diskSizeMax": 0,
  • "status": "created",
  • "duration": 0,
  • "rentalType": "demand",
  • "pricePerGpu": 0,
  • "pricePerDiskSize": 0,
  • "priceAutoRenewMax": 0,
  • "expiresAt": "2025-05-10T13:59:01+02:00",
  • "autoRenewAt": "2025-05-10T13:59:01+02:00",
  • "isAutoRenewOn": true,
  • "instanceTemplate": {
    },
  • "ports": {
    },
  • "cpuUsage": 0,
  • "memUsage": 0,
  • "diskUsage": 0,
  • "processUptime": 0,
  • "console": "string",
  • "consoleSystem": "string"
}

Delete Instance

Deletes a rental instance (Docker or VPS).

Authorizations:
apiKey
path Parameters
id
required
integer
Example: 1

Instance ID

Responses

Request samples 

curl --location --request DELETE 'https://api.simplepod.ai/instances/1' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{}

Pause Instance

Pauses one or more VPS instances. Accepts a mixed array of instance IDs and support IDs (e.g., 'V_abcd'). Paused instances retain their configuration and can be resumed later using the Resume VPS endpoint.

Authorizations:
apiKey
header Parameters
Content-Type
required
string
Example: application/merge-patch+json
Request Body schema: application/merge-patch+json
instanceIds
Array of any

Provide Instance IDs or support IDs

Responses

Request samples

Content type
application/merge-patch+json
{
  • "instanceIds": [
    ]
}

Response samples

Content type
application/json
{ }

My SSH Keys

Returns the authenticated user's saved SSH public keys. These keys can be referenced by IRI when renting VPS instances instead of providing a raw public key each time. Supports pagination and search filtering by key name.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

search
string
Example: search=ubuntu

Filter by search phrase

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/templates/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]

Billing

List of usage

Returns billing and usage data for the authenticated user's instances.

Authorizations:
apiKey
query Parameters
instanceId
integer
Example: instanceId=1

Instance ID

itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/billing/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
{ }

Instances Summary

Returns a summary of the authenticated user's active instances and rental availability, including current balance and estimated rental hours.

Authorizations:
apiKey

Responses

Response samples

Content type
application/json
{
  • "all": {
    },
  • "rentalAvailability": {
    }
}

Deposits

Returns the authenticated user's deposit history with pricing details and status.

Authorizations:
apiKey
query Parameters
itemsPerPage
integer
Example: itemsPerPage=100

Number of items returned

page
integer
Example: page=1

Number of page

Responses

Request samples 

curl --location --request GET 'https://api.simplepod.ai/instances/deposit/list' \
--header 'X-AUTH-TOKEN: apiKey'

Response samples

Content type
application/json
[
  • {
    }
]