Huddle01 Cloud
Security groups

List security groups

List all security groups for the authenticated user.

GET
/security-groups

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

region*string

Region code where the resource exists (e.g., eu2).

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://cloud.huddleapis.com/api/v1/security-groups?region=eu2"
{
  "security_groups": [
    {
      "id": "sg-9f3c7c2",
      "name": "allow-rtmp",
      "description": "Allow RTMP ingress from CDN nodes",
      "rules": [
        {
          "id": "sgr-0d8e12a",
          "direction": "ingress",
          "ether_type": "IPv4",
          "protocol": "tcp",
          "port_range_min": 80,
          "port_range_max": 80,
          "remote_ip_prefix": "0.0.0.0/0",
          "remote_group_id": "sg-9f3c7c2",
          "security_group_id": "sg-9f3c7c2",
          "created_at": "2024-03-18T10:20:00Z",
          "updated_at": "2024-03-18T10:22:00Z"
        }
      ],
      "created_at": "2024-03-18T10:20:00Z",
      "updated_at": "2024-03-18T10:22:00Z",
      "region": {
        "name": "eu2"
      }
    }
  ]
}
{
  "message": "Bad request",
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request body",
    "type": "client"
  },
  "timestamp": "2024-03-18T10:22:00Z"
}
{
  "message": "Unauthorized",
  "error": {
    "code": "UNAUTHORIZED",
    "message": "x-api-key header missing",
    "type": "auth"
  },
  "timestamp": "2024-03-18T10:22:00Z"
}
{
  "message": "Internal server error",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Failed to create instance",
    "type": "server"
  },
  "timestamp": "2024-03-18T10:22:00Z"
}