Skip to main content
The Container API enables you to create, manage, and interact with isolated Linux containers through the Rexec platform. Each container provides a fully functional terminal environment with customizable resources and pre-configured development tools.

​
Base URL

All API endpoints are relative to your Rexec instance: 
https://your-rexec-instance.com/api

​
Authentication

All Container API requests require authentication using a Bearer token in the Authorization header: 
Authorization: Bearer YOUR_API_TOKEN
Get your API token from the dashboard or use OAuth authentication.

​
Container Lifecycle

Containers follow this lifecycle:
  1. creating - Container is being pulled and initialized
  2. running - Container is active and ready for connections
  3. stopped - Container is stopped but data is preserved
  4. error - Container creation or operation failed

​
Available Endpoints

List Containers

Get all containers for your account

Create Container

Create a new sandboxed environment

Start Container

Start a stopped container

Stop Container

Stop a running container

​
Container Features

​
Resource Limits

Each container has configurable resource limits based on your subscription tier:
  • CPU - Millicores (1000 = 1 CPU core)
  • Memory - RAM allocation in MB
  • Disk - Storage quota in MB
  • Network - Bandwidth limits

​
Supported Images

Rexec supports multiple base images:
  • ubuntu:24.04 - Ubuntu 24.04 LTS
  • debian:bookworm - Debian 12
  • alpine:latest - Alpine Linux
  • archlinux:latest - Arch Linux
  • custom - Use your own Docker image

​
Development Roles

Pre-configured development environments:
  • node - Node.js development (nvm, npm, yarn)
  • python - Python development (pyenv, pip, poetry)
  • go - Go development (latest Go toolchain)
  • rust - Rust development (rustup, cargo)
  • devops - DevOps tools (docker, kubectl, terraform)
  • barebone - Minimal setup for custom configuration

​
Resource Tier Limits

  • CPU: 2 cores (2000 millicores)
  • Memory: 2GB
  • Disk: 10GB
  • Containers: 5 max
  • Session: 50 hours

​
Error Codes

Common error responses:
CodeDescription
401Unauthorized - Invalid or missing API token
403Forbidden - Container limit reached or insufficient permissions
404Not Found - Container does not exist
409Conflict - Container name already exists
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Server-side error

​
Rate Limits

  • Container Creation: 10 per minute
  • Container Operations: 60 per minute
  • List Operations: 120 per minute

​
SDK Support

Go SDK

Official Go client library

JavaScript/TypeScript SDK

Official Node.js and browser SDK

​
Next Steps

Create Your First Container

Learn how to create a container

Terminal API

Connect to container terminals

Build docs developers (and LLMs) love

Get started for freeTalk to us