Huddle01 Cloud
Instances

Perform instance action

Execute a lifecycle action on an instance.

Supported actions:

  • start — Start a stopped instance (resumes billing)
  • stop — Stop a running instance (stops billing)
  • reboot — Reboot the instance (supports SOFT or HARD type)
  • pause — Pause the instance (stops billing)
  • unpause — Unpause a paused instance (resumes billing)
  • suspend — Suspend the instance to disk (stops billing)
  • resume — Resume a suspended instance (resumes billing)
POST
/instances/{id}/action

Authorization

ApiKeyAuth
X-API-Key<token>

API key for authentication. Generate from the Huddle01 Cloud dashboard.

In: header

Path Parameters

id*string

Instance ID

Query Parameters

region*string

Region code (e.g., eu2, us1)

Header Parameters

Idempotency-Key?string

Unique key to ensure idempotent request handling

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://cloud.huddleapis.com/api/v1/instances/string/action?region=string" \  -H "Content-Type: application/json" \  -d '{    "action": "start"  }'
{
  "instance": {
    "id": "string",
    "name": "string",
    "vcpus": 0,
    "ram": 0,
    "status": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "image": {
      "id": "string",
      "name": "string",
      "distribution": "string",
      "distribution_version": "string"
    },
    "networks": {
      "v4": [
        {
          "ip_address": "string",
          "type": "string"
        }
      ],
      "v6": [
        {
          "ip_address": "string",
          "type": "string"
        }
      ]
    },
    "region": {
      "name": "eu2"
    }
  }
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}