---
title: "Aguasto Instance API | Aguasto"
description: "Read workspace instance metadata, status and usage through a scoped API key. Understand which lifecycle operations remain closed during GPU early access."
canonical: "https://www.aguasto.com/developers/instances"
last-updated: "2026-11-17"
---

# Aguasto Instance API | Aguasto

Canonical HTML: [Instances](https://www.aguasto.com/developers/instances)

> Read workspace instance metadata, status and usage through a scoped API key. Understand which lifecycle operations remain closed during GPU early access.

[Home](https://www.aguasto.com/) [Developers](https://www.aguasto.com/developers) Instances

Developers

## Aguasto Instance API

Read workspace instance metadata, status and usage through a scoped API key. Understand which lifecycle operations remain closed during GPU early access.

### Read instance metadata

Use a Console session or an instances:read key for GET /api/instances. The collection is workspace-scoped and returns up to 500 recent records. Use the Aguasto instance ID for correlation and SKU ID for configuration identity. Treat the returned status as authoritative and handle unfamiliar future status values gracefully.

curl -fsS https://console.aguasto.com/api/instances \\ -H "X-Aguasto-API-Key: $AGUASTO\_API\_KEY"

### Handle lifecycle actions

The read key exposes summary metadata, including usage and reserved amounts. Public early access provides no paid provisioning. Lifecycle controls for eligible instances depend on the instance state and the permissions enforced by the Console.

### Frequently asked questions

#### Is a mock instance an SSH target?

No. A record marked isMock represents a test lifecycle. It does not provide GPU hardware or an operating SSH host.

### Continue building

- [Read usage and export statements](https://www.aguasto.com/developers/usage)

- [Console early-access OpenAPI](https://www.aguasto.com/compute-openapi.json)

## Company navigation

- [API versioning policy](https://www.aguasto.com/developers/versioning)
- [Developer sandbox](https://www.aguasto.com/sandbox)
- [Home](https://www.aguasto.com/)
- [Infrastructure](https://www.aguasto.com/infrastructure)
- [GPU Cloud](https://www.aguasto.com/gpu-cloud)
- [AI Inference](https://www.aguasto.com/ai-inference)
- [Development & Investment](https://www.aguasto.com/development)
- [Company](https://www.aguasto.com/company)
- [Contact](https://www.aguasto.com/contact)
- [Privacy](https://www.aguasto.com/privacy)
- [Terms of use](https://www.aguasto.com/terms)
- [Solutions](https://www.aguasto.com/solutions)
- [AI training](https://www.aguasto.com/solutions/ai-training)
- [AI inference](https://www.aguasto.com/solutions/ai-inference)
- [Fine-tuning](https://www.aguasto.com/solutions/fine-tuning)
- [Agentic AI](https://www.aguasto.com/solutions/agentic-ai)
- [AI agents](https://www.aguasto.com/solutions/ai-agents)
- [Large language models](https://www.aguasto.com/solutions/large-language-models)
- [Long-context inference](https://www.aguasto.com/solutions/long-context-inference)
- [Video generation](https://www.aguasto.com/solutions/video-generation)
- [Rendering](https://www.aguasto.com/solutions/rendering)
- [Scientific computing](https://www.aguasto.com/solutions/scientific-computing)
- [Engineering simulation](https://www.aguasto.com/solutions/engineering-simulation)
- [High-performance computing](https://www.aguasto.com/solutions/high-performance-computing)
- [Reinforcement learning](https://www.aguasto.com/solutions/reinforcement-learning)
- [Data science](https://www.aguasto.com/solutions/data-science)
- [Startups](https://www.aguasto.com/solutions/startups)
- [Enterprise](https://www.aguasto.com/solutions/enterprise)
- [Pricing](https://www.aguasto.com/gpu-cloud/pricing)
- [Availability](https://www.aguasto.com/gpu-cloud/availability)
- [Flex](https://www.aguasto.com/gpu-cloud/flex)
- [On-Demand](https://www.aguasto.com/gpu-cloud/on-demand)
- [Reserved capacity](https://www.aguasto.com/gpu-cloud/reserved)
- [Regions](https://www.aguasto.com/gpu-cloud/regions)
- [United States](https://www.aguasto.com/gpu-cloud/regions/united-states)
- [Europe](https://www.aguasto.com/gpu-cloud/regions/europe)
- [Mission](https://www.aguasto.com/company/mission)
- [Modular data centers](https://www.aguasto.com/company/modular-data-centers)
- [Technology](https://www.aguasto.com/company/technology)
- [Company roadmap](https://www.aguasto.com/company/roadmap)
- [Trust](https://www.aguasto.com/trust)
- [Security](https://www.aguasto.com/security)
- [Status](https://www.aguasto.com/status)
- [Support](https://www.aguasto.com/support)
- [Acceptable use](https://www.aguasto.com/legal/acceptable-use)
- [Data processing agreements](https://www.aguasto.com/legal/dpa)
- [Subprocessors](https://www.aguasto.com/legal/subprocessors)
- [Cookies](https://www.aguasto.com/legal/cookies)
- [REST API](https://www.aguasto.com/developers/api)
- [Quickstart](https://www.aguasto.com/developers/quickstart)
- [Authentication](https://www.aguasto.com/developers/authentication)
- [API keys](https://www.aguasto.com/developers/api-keys)
- [GPU catalogue data](https://www.aguasto.com/developers/gpu-catalog)
- [Availability](https://www.aguasto.com/developers/availability)
- [Pricing](https://www.aguasto.com/developers/pricing)
- [Deployments](https://www.aguasto.com/developers/deployments)
- [Instances](https://www.aguasto.com/developers/instances)
- [Usage](https://www.aguasto.com/developers/usage)
- [Billing and wallet](https://www.aguasto.com/developers/billing)
- [Webhooks](https://www.aguasto.com/developers/webhooks)
- [SDKs and CLI](https://www.aguasto.com/developers/sdks)
- [Errors](https://www.aguasto.com/developers/errors)
- [Rate limits](https://www.aguasto.com/developers/rate-limits)
- [Build with AI agents](https://www.aguasto.com/developers/agents)
- [MCP](https://www.aguasto.com/developers/mcp)
- [A2A](https://www.aguasto.com/developers/a2a)
- [GPU roadmap](https://www.aguasto.com/gpu-roadmap)
- [Research topics](https://www.aguasto.com/topics)
- [GPU systems & local clusters](https://www.aguasto.com/topics/gpu-systems)
- [Model serving & inference](https://www.aguasto.com/topics/model-serving)
- [Modular infrastructure & resources](https://www.aguasto.com/topics/modular-infrastructure)
- [Compute economics & evidence](https://www.aguasto.com/topics/compute-economics)
- [Glossary](https://www.aguasto.com/glossary)
- [Methodologies](https://www.aguasto.com/methodologies)
- [Blog](https://www.aguasto.com/blog)
- [How to write a GPU capacity request](https://www.aguasto.com/blog/write-a-gpu-capacity-request)
- [How to read a GPU hardware roadmap](https://www.aguasto.com/blog/read-a-gpu-hardware-roadmap)
- [Read the GPU catalogue from a script](https://www.aguasto.com/blog/read-the-gpu-catalogue-from-a-script)
- [Developers](https://www.aguasto.com/developers)
- [Resources](https://www.aguasto.com/resources)
- [GPU catalogue](https://www.aguasto.com/gpus)
- [Model Index](https://www.aguasto.com/models)
- [Inference Stack](https://www.aguasto.com/inference-stack)
- [Learn](https://www.aguasto.com/learn)
- [Insights](https://www.aguasto.com/insights)
- [Research](https://www.aguasto.com/research)
- [Industry cases](https://www.aguasto.com/research/cases)
- [Why Modular](https://www.aguasto.com/infrastructure/why-modular)
- [Cooling & Resource Efficiency](https://www.aguasto.com/infrastructure/cooling-resource-efficiency)
- [Partners](https://www.aguasto.com/partners)
- [GPU comparison](https://www.aguasto.com/gpus/compare)
- [Model comparison](https://www.aguasto.com/models/compare)
- [Engineering tools](https://www.aguasto.com/tools)
- [Development friction](https://www.aguasto.com/research/hyperscale-development-friction)
- [NVIDIA A100 40GB](https://www.aguasto.com/gpus/a100-40gb)
- [NVIDIA A100 80GB](https://www.aguasto.com/gpus/a100-80gb)
- [NVIDIA H100 PCIe](https://www.aguasto.com/gpus/h100-pcie)
- [NVIDIA H100 SXM](https://www.aguasto.com/gpus/h100)
- [NVIDIA GH200](https://www.aguasto.com/gpus/gh200)
- [NVIDIA H200 SXM](https://www.aguasto.com/gpus/h200)
- [NVIDIA H200 NVL](https://www.aguasto.com/gpus/h200-nvl)
- [NVIDIA B200 SXM](https://www.aguasto.com/gpus/b200)
- [NVIDIA B300](https://www.aguasto.com/gpus/b300)
- [NVIDIA GB200](https://www.aguasto.com/gpus/gb200)
- [NVIDIA GB300](https://www.aguasto.com/gpus/gb300)
- [NVIDIA GB200 NVL72](https://www.aguasto.com/gpus/gb200-nvl72)
- [NVIDIA GB300 NVL72](https://www.aguasto.com/gpus/gb300-nvl72)
- [NVIDIA Vera Rubin Platform](https://www.aguasto.com/platforms/nvidia-vera-rubin)
- [NVIDIA Rubin GPU](https://www.aguasto.com/gpus/nvidia-rubin)
- [NVIDIA Vera Rubin NVL72](https://www.aguasto.com/systems/nvidia-vera-rubin-nvl72)
- [NVIDIA DGX Rubin NVL8](https://www.aguasto.com/systems/nvidia-dgx-rubin-nvl8)
- [NVIDIA HGX Rubin NVL8](https://www.aguasto.com/systems/nvidia-hgx-rubin-nvl8)
- [NVIDIA Vera Rubin NVL4](https://www.aguasto.com/systems/nvidia-vera-rubin-nvl4)
- [NVIDIA Rubin CPX](https://www.aguasto.com/gpus/nvidia-rubin-cpx)
- [NVIDIA Vera Rubin NVL144 CPX](https://www.aguasto.com/systems/nvidia-vera-rubin-nvl144-cpx)
- [NVIDIA Rubin HPC](https://www.aguasto.com/gpus/nvidia-rubin-hpc)
- [NVIDIA Vera CPU](https://www.aguasto.com/components/nvidia-vera-cpu)
- [NVIDIA Groq 3 LPX](https://www.aguasto.com/components/nvidia-groq-3-lpx)
- [NVIDIA Vera BlueField-4 STX](https://www.aguasto.com/components/nvidia-bluefield-4-stx)
- [NVIDIA Spectrum-6 SPX Ethernet](https://www.aguasto.com/components/nvidia-spectrum-6-spx-ethernet)
- [AMD Instinct MI300X](https://www.aguasto.com/gpus/mi300x)
- [AMD Instinct MI325X](https://www.aguasto.com/gpus/mi325x)
- [AMD Instinct MI355X](https://www.aguasto.com/gpus/mi355x)
- [AMD Instinct MI455X](https://www.aguasto.com/gpus/mi455x)
- [AMD Helios](https://www.aguasto.com/gpus/helios)
- [NVIDIA L40](https://www.aguasto.com/gpus/l40)
- [NVIDIA L40S](https://www.aguasto.com/gpus/l40s)
- [NVIDIA RTX PRO 6000 Blackwell Server Edition](https://www.aguasto.com/gpus/rtx-pro-6000)
- [NVIDIA RTX 6000 Ada Generation](https://www.aguasto.com/gpus/rtx-6000-ada)
- [GLM-4.5](https://www.aguasto.com/models/glm-4-5)
- [Qwen3-235B-A22B](https://www.aguasto.com/models/qwen3-235b-a22b)
- [DeepSeek-R1](https://www.aguasto.com/models/deepseek-r1)
- [Llama 3.3 70B Instruct](https://www.aguasto.com/models/llama-3-3-70b-instruct)
- [Gemma 3 27B IT](https://www.aguasto.com/models/gemma-3-27b-it)
- [gpt-oss-120b](https://www.aguasto.com/models/gpt-oss-120b)
- [Kimi-K2-Instruct](https://www.aguasto.com/models/kimi-k2-instruct)
- [GLM-5.3](https://www.aguasto.com/models/glm-5-3)
- [Qwen3.8-27B](https://www.aguasto.com/models/qwen3-8-27b)
- [DeepSeek-V4.1-Flash](https://www.aguasto.com/models/deepseek-v4-1-flash)
- [Llama 4 Scout 17B-16E Instruct](https://www.aguasto.com/models/llama-4-scout-17b-16e-instruct)
- [Gemma 4 31B IT](https://www.aguasto.com/models/gemma-4-31b-it)
- [Kimi K3](https://www.aguasto.com/models/kimi-k3)
- [vLLM](https://www.aguasto.com/inference-stack/vllm)
- [SGLang](https://www.aguasto.com/inference-stack/sglang)
- [TensorRT-LLM](https://www.aguasto.com/inference-stack/tensorrt-llm)
- [NVIDIA Dynamo](https://www.aguasto.com/inference-stack/dynamo)
- [NVIDIA Triton Inference Server](https://www.aguasto.com/inference-stack/triton)
- [AMD ROCm](https://www.aguasto.com/inference-stack/rocm)
- [Ray Serve](https://www.aguasto.com/inference-stack/ray-serve)
- [Kubernetes GPU orchestration — NVIDIA device plugin](https://www.aguasto.com/inference-stack/kubernetes)
- [Model weights are only the beginning of the memory budget](https://www.aguasto.com/learn/model-weights-and-runtime-memory)
- [Why tokens per second is not enough to benchmark inference](https://www.aguasto.com/research/inference-benchmark-methodology)
- [Prefill, decode and the cost of separating them](https://www.aguasto.com/learn/prefill-decode-and-disaggregated-serving)
- [Choosing between vLLM, SGLang and TensorRT-LLM](https://www.aguasto.com/learn/choosing-an-inference-serving-framework)
- [From Power to Inference—Building a Distributed AI Compute Network](https://www.aguasto.com/learn/from-power-to-inference)
- [Dedicated compute and shared inference: compare the whole workload](https://www.aguasto.com/insights/dedicated-and-shared-inference-economics)
- [Distributed inference reliability begins with the failure boundary](https://www.aguasto.com/learn/distributed-inference-reliability)
- [Core Scientific: reading contracted, energized and billed capacity](https://www.aguasto.com/research/cases/core-scientific-capacity-disclosures)
- [Why Modular AI Infrastructure Matters Now](https://www.aguasto.com/research/why-modular-ai-infrastructure-matters-now)
- [What Is a Modular AI Data Center?](https://www.aguasto.com/learn/what-is-a-modular-ai-data-center)
- [How Modular AI Data Centers Are Built and Commissioned](https://www.aguasto.com/learn/modular-data-center-factory-to-commissioning)
- [Liquid Cooling for High-Density GPU Systems: Follow the Interfaces](https://www.aguasto.com/learn/liquid-cooling-gpu-rack-interfaces)
- [Why Electricity Availability Shapes AI Infrastructure Deployment](https://www.aguasto.com/research/electricity-availability-and-time-to-power)
- [What Is KV Cache? Capacity, Reuse and Isolation](https://www.aguasto.com/learn/kv-cache-capacity-and-policy)
- [Continuous Batching: Throughput Without Hiding Latency](https://www.aguasto.com/learn/continuous-batching-and-latency)
- [Applied Digital: Reading the Polaris Forge 1 Delivery Milestones](https://www.aguasto.com/research/cases/applied-digital-polaris-forge-capacity-milestones)
- [Crusoe Abilene: Separate Delivered Infrastructure from Expansion Plans](https://www.aguasto.com/research/cases/crusoe-abilene-delivery-and-expansion)
- [Data Center Cooling: Choosing Air, Liquid, Dry and Hybrid Architectures](https://www.aguasto.com/learn/data-center-cooling-air-liquid-dry-hybrid)
- [Can Data Centers Reduce Water Consumption? Define the Water Boundary First](https://www.aguasto.com/research/data-center-water-consumption-and-withdrawal)
- [Measuring PUE, WUE and AI Compute Efficiency at the Right Boundary](https://www.aguasto.com/learn/measuring-pue-wue-and-ai-compute-efficiency)
- [The Environmental Trade-offs of High-Density AI Infrastructure](https://www.aguasto.com/research/environmental-tradeoffs-and-infrastructure-reuse)
- [Selecting GPU Systems for Enterprise Inference](https://www.aguasto.com/learn/selecting-enterprise-inference-gpu-systems)
- [Networking Rack-Scale AI Systems: Define the Communication Boundary](https://www.aguasto.com/learn/rack-scale-ai-networking-boundaries)
- [Official LinkedIn](https://www.linkedin.com/company/aguasto)

This is a generated representation of the public HTML page. Diagrams are conceptual. GPU and inference services are planned and are not currently available to book or call. The contact page describes the available inquiry flow.
