Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/brimblehq/rexec/llms.txt

Use this file to discover all available pages before exploring further.

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