Overview

AIC Cloud API

The AIC Cloud API gives you programmatic access to all our cloud services — email hosting, VPS management, app deployment, object storage, and domain registration. Build integrations, automate infrastructure, or power your SaaS with our REST API.

by Applied Intelligence Corporation

7 Services

Full REST API

69+ Endpoints

CRUD operations

API Key Auth

SHA-256 hashed

JSON Format

Request & Response

Base URLhttps://api.aiccloud.inHTTPS

OpenAPI 3.1https://api.aiccloud.in/openapi.jsonView spec ↗

Import the spec into Postman, feed it into Swagger UI, or generate typed SDKs with openapi-typescript, openapi-generator, or Stainless.

Authentication

API Key Authentication

All API requests require authentication using an API key. Create keys from your dashboard settings.

1

Create Key

Dashboard → Settings → API Keys

2

Copy Securely

Key is shown only once after creation

3

Add to Headers

Use Bearer token or X-API-Key header

Authorization Header

Authorization: Bearer aic_your_key_here

X-API-Key Header

X-API-Key: aic_your_key_here

Quick Start

Make Your First Request

List all your VPS instances with a single API call:

curl -X GET "https://api.aiccloud.in/api/v1/vps" \
  -H "Authorization: Bearer aic_your_api_key_here"

Email

Email API

Manage email domains, mailboxes, aliases, and DKIM configuration.

Base path: /api/v1/email

List all domains and mailboxes

Add a new email domain

Verify domain DNS records

Generate DKIM keys for domain

Delete domain and all its mailboxes

Create a new mailbox

Delete a mailbox

Change mailbox password

Get mailbox sending status

Create email alias

List all aliases for a domain

Delete an alias

Essential VPS

Essential VPS API

Create and manage Essential VPS instances with full lifecycle control.

Base path: /api/v1/vps

List your VPS instances

Create a new VPS instance

Get live CPU, memory, disk stats

Start a stopped VPS

Stop a running VPS

Restart VPS

Permanently delete a VPS

Upgrade to a higher plan

Reinstall operating system

Change root password

Shared Hosting

Shared Hosting API

Managed PHP/WordPress hosting on HestiaCP. Three tiers (Starter ₹49 / Business ₹149 / Pro ₹249), container-isolated. List & lifecycle operations via API key; checkout stays browser-only for payment security.

Base path: /api/v1/shared-hosting

List the 3 active plans (public — no auth required)

List all shared hosting subscriptions for your org

Full detail — plan + sites + mailboxes + databases + live HestiaCP stats + MTD bandwidth

Suspend (sites go offline; data retained)

Resume a suspended subscription

Cancel — soft by default; set hardDelete=true to purge immediately

Change tier (no downtime; HestiaCP package + cgroups re-applied)

Mint a one-shot autologin URL into HestiaCP control panel

Cloud VPS

Cloud VPS API

Provision and manage high-performance Cloud VPS instances.

Base path: /api/v1/cloud-vps

List available Cloud VPS plans

List your Cloud VPS instances

Get instance details

Get SSH credentials

Start instance

Stop instance

Restart instance

Terminate instance

Dedicated Servers

Dedicated Servers API

Browse and manage bare-metal dedicated servers.

Base path: /api/v1/dedicated-servers

List available dedicated server plans

List your dedicated servers

Get server details

Reboot server

Terminate server

App Hosting

App Hosting API

Deploy and manage applications from GitHub repositories.

Base path: /api/v1/apps

List your deployed apps

Create and deploy a new app

Get app details

Trigger a new deployment

Update environment variables

Start app

Stop app

Restart app

Delete app permanently

Get application logs

List deployment history

Storage

Storage API

S3-compatible object storage with access keys and usage tracking.

Base path: /api/v1/storage

List all storage buckets

Create a new storage bucket

Delete a bucket and all objects

Get S3 access credentials

Get real-time usage metrics

Get storage subscription details

Domains

Domains API

Search, register, transfer domains and manage DNS records.

Base path: /api/v1/domains

Search domain availability

List TLDs with pricing

List your registered domains

Get domain details

List DNS records

Create a DNS record

Delete a DNS record

Register a new domain

Transfer a domain in

Reference

Rate Limits

Rate limits are enforced per API key on a rolling 1-hour window.

PlanLimitWindow

Free100 requestsper hour

Pro1,000 requestsper hour

Enterprise10,000 requestsper hour

When you exceed the rate limit, the API returns 429 Too Many Requests with a retry_after_seconds field. Need higher limits? Contact us.

Reference

Error Responses

All errors return a JSON object with error and statusCode fields.

Error Format

{
  "error": "Invalid or revoked API key",
  "statusCode": 401
}

CodeStatusDescription

400Bad RequestThe request body or parameters are invalid

401UnauthorizedAPI key is missing, invalid, or revoked

403ForbiddenEndpoint is not available via API key (dashboard-only)

404Not FoundThe requested resource does not exist

409ConflictResource already exists or state conflict

429Too Many RequestsYou have exceeded the rate limit for your plan

500Server ErrorSomething went wrong on our end