Theta EdgeCloud API

While you can manage GPU Nodes in the Theta EdgeCloud Dashboard, you can also use the Theta EdgeCloud API to discover GPU capacity, manage deployments, and retrieve project billing data programmatically. This section walks you through the production API and its common workflows.

Production endpoint

https://controller.thetaedgecloud.com

All endpoints in this section use API version v1 and require a project-scoped API key in the x-api-key header.

Get started

Create a project API key in the Theta EdgeCloud Dashboard.
Follow Authentication and Quick Start to configure your shell safely.
Discover available GPU resources.
Create and manage GPU Nodes.
Read balance, usage, top-up, and pricing data.

Endpoint summary

Capability	Method and path
List GPU resources	`GET /v1/projects/{projectId}/gpu-resources`
Get a GPU resource	`GET /v1/projects/{projectId}/gpu-resources/{resourceId}`
List GPU Node templates	`GET /v1/projects/{projectId}/gpu-deployment-templates`
List or create GPU Nodes	`GET, POST /v1/projects/{projectId}/gpu-deployments`
Get or delete a GPU Node	`GET, DELETE /v1/projects/{projectId}/gpu-deployments/{deploymentId}`
Start or stop a GPU Node	`POST /v1/projects/{projectId}/gpu-deployments/{deploymentId}/start`, `/stop`
Read GPU Node events or logs	`GET /v1/projects/{projectId}/gpu-deployments/{deploymentId}/events`, `/logs`
Read billing data	`GET /v1/projects/{projectId}/billing/{balance,usage,top-ups,pricing}`

Successful responses use the following envelope:

{
  "status": "success",
  "body": {}
}

🚧
Creating or starting a GPU Node provisions billable capacity. Stopping a GPU Node retains its restartable configuration. Deleting a GPU Node permanently removes that configuration.