Crusoe Cloud API Gateway

Name: Crusoe Cloud API Gateway API
Brand: Crusoe Cloud API Gateway
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCloud InfrastructureComputeapiKey95 EndpointsREST

For Agents

Provision and manage GPU and CPU VMs, networking, storage, and projects on Crusoe Cloud's GPU-focused IaaS platform.

Quickstart

Get started with Crusoe Cloud API Gateway in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"provision a GPU virtual machine"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Crusoe Cloud API Gateway API.

Provision GPU and CPU VM instances individually or in bulk under a project

Manage instance groups and instance templates for repeatable VM topologies

Create and resize persistent disks, attach and detach them from VMs

Configure VPC networks, subnets, and firewall rules per project

GET STARTED

Start building with Crusoe Cloud API Gateway API

Explore with Jentic

View OpenAPI Document

Use for: Provision a new GPU VM instance in a Crusoe Cloud project, Bulk create 8 H100 instances under project proj_abc, List every Crusoe Cloud location available for resource hosting, Attach a persistent disk to a running VM

Not supported: Does not handle in-VM workload orchestration, container runtime, or model training framework code — use for cloud infrastructure provisioning and management only.

Jentic publishes the only available OpenAPI document for Crusoe Cloud API Gateway, keeping it validated and agent-ready.

The Crusoe Cloud API Gateway exposes 95 endpoints covering the full Crusoe Cloud product surface: VM instances and instance groups, VM templates, VM types, instance images, persistent disks, snapshots, VPC networks, subnets, firewall rules, Infiniband networks and partitions, load balancers, organisations, projects, usage and billing, identities, SSH keys, tokens, and capacity lookups. The base URL is https://api.crusoecloud.com/v1alpha5 and most resources are scoped under a project_id path segment.

Use Cases

Patterns agents use Crusoe Cloud API Gateway API for, with concrete tasks.

★ GPU Training Cluster Provisioning

Spin up a multi-node GPU training cluster by bulk-creating VM instances, attaching shared disks, and connecting them to an Infiniband partition for high-bandwidth interconnect. Crusoe Cloud exposes Infiniband as a first-class resource, which most general-purpose IaaS APIs do not.

POST /projects/{project_id}/networking/ib-partitions to create the partition, then POST /projects/{project_id}/compute/vms/bulk-instances with eight VMs referencing that partition.

Cost-Aware Inference Fleet

Manage an inference fleet that scales up during the day and down overnight by combining instance-groups for fleet topology with PATCH calls to change VM state. Pull /organizations/usage to verify cost trends after each scaling cycle.

PATCH /projects/{project_id}/compute/instance-groups/{instance_group_id} to resize the group at 8am, reverse the change at 8pm, and read /organizations/usage to confirm spend.

Per-Project VPC Hardening

Keep each Crusoe Cloud project's network surface tight by listing VPC firewall rules, removing unused entries, and patching the remainder to use up-to-date CIDRs. Useful for ongoing security hygiene as engineering teams roll on and off projects.

GET /projects/{project_id}/networking/vpc-firewall-rules, identify rules with overly broad source ranges, and PATCH each to a tighter CIDR.

Image and Template Catalog Sync

Mirror Crusoe Cloud's available VM images and instance templates into an internal catalog so platform teams can decide which images are blessed for production use. Updates are detected by diffing the listing endpoints on a schedule.

GET /compute/images and GET /projects/{project_id}/compute/instance-templates, diff against the cached catalog, and surface any new images or templates for review.

Agent-Driven GPU Operations

Allow an AI ops agent to handle GPU infrastructure chores — provisioning, attaching disks, opening firewall rules — through Jentic so the Crusoe access token stays in the vault and only scoped requests reach the runtime.

Search Jentic for 'provision a GPU virtual machine', load the create-VM operation, and execute it with the chosen VM type and project ID.

Key Endpoints

95 endpoints — the crusoe cloud api gateway exposes 95 endpoints covering the full crusoe cloud product surface: vm instances and instance groups, vm templates, vm types, instance images, persistent disks, snapshots, vpc networks, subnets, firewall rules, infiniband networks and partitions, load balancers, organisations, projects, usage and billing, identities, ssh keys, tokens, and capacity lookups.

METHOD

PATH

DESCRIPTION

POST

/projects/{project_id}/compute/vms/instances

Create a VM instance

POST

/projects/{project_id}/compute/vms/bulk-instances

Bulk create VM instances

POST

/projects/{project_id}/storage/disks

Create a persistent disk

POST

/projects/{project_id}/networking/vpc-firewall-rules

Create a VPC firewall rule

POST

/projects/{project_id}/networking/ib-partitions

Create an Infiniband partition

POST

/projects/{project_id}/networking/load-balancers

Create a load balancer

GET

/organizations/usage

Read project-level usage

GET

/locations

List available Crusoe Cloud locations

POST

/projects/{project_id}/compute/vms/instances

Create a VM instance

POST

/projects/{project_id}/compute/vms/bulk-instances

Bulk create VM instances

POST

/projects/{project_id}/storage/disks

Create a persistent disk

POST

/projects/{project_id}/networking/vpc-firewall-rules

Create a VPC firewall rule

POST

/projects/{project_id}/networking/ib-partitions

Create an Infiniband partition

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Crusoe Cloud access tokens are stored encrypted in the Jentic vault. Agents never see the raw token — Jentic injects it into the Authorization header at execution time.

Intent-based discovery

Agents search Jentic by intent (e.g. 'provision a GPU virtual machine') and Jentic returns the matching create-VM or networking operation along with its parameter schema.

Time to first call

Direct integration: 3-5 days to wire the 95 endpoints, project scoping, async operation polling, and rate-limit handling. Through Jentic: minutes per operation.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Crunchy Bridge API

Managed PostgreSQL clusters that pair well with Crusoe-hosted compute.

Pair when the agent provisions both compute (Crusoe) and a managed Postgres tier (Crunchy Bridge).

Complementary

Crunchy Bridge API

Sister Crunchy surface that can act as the database layer for Crusoe-hosted workloads.

Pick when the agent needs richer Postgres role and access-token management alongside the Crusoe compute provisioning.

Complementary

Crustdata API

External data enrichment for workloads running on Crusoe Cloud.

Use Crustdata to feed enrichment data into a model or job running on a Crusoe VM.

FAQs

Specific to using Crusoe Cloud API Gateway API through Jentic.

What authentication does the Crusoe Cloud API Gateway use?

The OpenAPI specification does not declare a security scheme. In practice Crusoe Cloud uses an API access token issued from the Crusoe console — pass it in the Authorization header. Through Jentic the token is stored encrypted in the vault and never enters the agent prompt.

Can I provision a GPU VM with the Crusoe Cloud API?

Yes. POST /projects/{project_id}/compute/vms/instances creates a new VM in the target project. Use POST /projects/{project_id}/compute/vms/bulk-instances when you need many VMs at once, for example to spin up a training cluster.

How do I set up an Infiniband partition for a GPU cluster through the Crusoe Cloud API?

First GET /projects/{project_id}/networking/ib-networks to find an existing Infiniband network, then POST /projects/{project_id}/networking/ib-partitions to create a partition that VMs in the cluster can join.

How do I track an async VM creation operation?

VM creation returns an operation_id. Poll GET /projects/{project_id}/compute/vms/instances/operations/{operation_id} until the operation reaches a terminal state, then call GET /projects/{project_id}/compute/vms/instances/{vm_id} for the running VM.

What are the rate limits for the Crusoe Cloud API?

The OpenAPI specification does not document numeric rate limits. Watch for HTTP 429 responses and contact Crusoe Cloud support before running high-frequency provisioning loops.

How do I provision a GPU VM through Jentic?

Run pip install jentic, search 'provision a GPU virtual machine', load the create-VM operation, and execute it with your project_id and VM type. Jentic injects the Crusoe access token automatically.