Skip to main content
The Archil Control Plane API provides programmatic access to manage disks, mounts, and authentication tokens in the Archil distributed filesystem platform.

​
Base URL

Each region has its own control plane endpoint:
RegionEndpoint
AWS US East (N. Virginia)control.green.us-east-1.aws.prod.archil.com
AWS EU West (Ireland)control.green.eu-west-1.aws.prod.archil.com
AWS US West (Oregon)control.green.us-west-2.aws.prod.archil.com
GCP US Central (Iowa)control.blue.us-central1.gcp.prod.archil.com

​
Authentication

All endpoints require an API key: 
Authorization: key-{API_KEY}
Create API keys in the Archil Console or via the API.

​
Response Format

All responses use a consistent envelope: 
{
  "success": true,
  "data": { ... }
}

​
HTTP Status Codes

CodeDescription
200Success
400Bad request (validation error)
403Forbidden (auth failure or access denied)
404Not found
500Internal server error

​
Disk ID Format

Disks are identified by a unique ID in the format: 
dsk-{16 hex characters}
For example: dsk-0123456789abcdef

​
Getting Started

  1. Create an API token in the console or via API
  2. Use the token in the Authorization header for all requests
  3. Create your first disk