Authentication
All API requests require a Bearer token in the Authorization header. Generate your API key from the Dashboard → API Keys section.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Important: Keep your API key secure. Do not expose it in client-side code or public repositories. If compromised, regenerate it immediately from your dashboard.
Base URL
https://api.algodelta.in/v1
All endpoints are relative to this base URL. All requests and responses use JSON format.
Create Server
Provision a new IPv4 or IPv6 server.
// Request Body
{
"type": "ipv4", // "ipv4" or "ipv6"
"label": "my-prod-app" // Optional label for identification
}
// Response (201 Created)
{
"success": true,
"data": {
"id": "srv_7x8k2m",
"type": "ipv4",
"ip": "103.45.67.89",
"status": "provisioning",
"label": "my-prod-app",
"ssh_user": "root",
"ssh_password": "auto-generated-password",
"created_at": "2026-03-30T10:00:00Z",
"price": {
"base": 400,
"gst": 72,
"total": 472,
"currency": "INR"
}
}
}
The server status will change from provisioning to active within 30 seconds. Poll the Get Server endpoint to check status.
List Servers
Retrieve all servers under your account.
// Query Parameters (optional)
?type=ipv4 // Filter by type
&status=active // Filter by status
&page=1&limit=20 // Pagination
// Response (200 OK)
{
"success": true,
"data": [
{
"id": "srv_7x8k2m",
"type": "ipv4",
"ip": "103.45.67.89",
"status": "active",
"label": "my-prod-app",
"created_at": "2026-03-30T10:00:00Z"
}
],
"pagination": {
"total": 5,
"page": 1,
"limit": 20,
"pages": 1
}
}
Get Server Details
Retrieve detailed information about a specific server.
// Response (200 OK)
{
"success": true,
"data": {
"id": "srv_7x8k2m",
"type": "ipv4",
"ip": "103.45.67.89",
"status": "active",
"label": "my-prod-app",
"ssh_user": "root",
"uptime": "99.98%",
"created_at": "2026-03-30T10:00:00Z",
"next_billing": "2026-04-30T00:00:00Z",
"price": {
"base": 400,
"gst": 72,
"total": 472,
"currency": "INR"
}
}
}
Delete Server
Permanently terminate and delete a server. This action is irreversible. All data will be destroyed.
// Response (200 OK)
{
"success": true,
"message": "Server srv_7x8k2m has been terminated.",
"data": {
"id": "srv_7x8k2m",
"status": "terminated",
"terminated_at": "2026-03-30T15:30:00Z"
}
}
Error Codes
| HTTP Code |
Error |
Description |
| 400 | Bad Request | Invalid request parameters |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | Insufficient permissions |
| 404 | Not Found | Server or resource not found |
| 409 | Conflict | Resource already exists |
| 429 | Rate Limited | Too many requests |
| 500 | Server Error | Internal error — contact support |
{
"success": false,
"error": {
"code": "INVALID_SERVER_TYPE",
"message": "Server type must be 'ipv4' or 'ipv6'.",
"status": 400
}
}
Rate Limits
- Server Creation: 10 requests per minute
- Server Listing/Details: 60 requests per minute
- Server Deletion: 10 requests per minute
Rate limit headers are included in all API responses:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1711789200