API reference
The HepCloud API is compatible with the hcloud API standard. The endpoint is:
https://api.hepcloud.net/v1
Authentication
Create a token on the API Tokens page in the console and send it in the
Authorization header:
curl -H "Authorization: Bearer <token>" https://api.hepcloud.net/v1/servers
Tokens are scoped to a project and are created with either read-only or
read-write permission. A read-only token receives a token_readonly error
on write requests.
Tools
The hcloud command line tool and the Terraform provider work as they are once you change the endpoint. Setup, environment variables and a worked example: Command line and Terraform.
All endpoints
The endpoints below can be used with an API token. Account security (2FA, sessions), token management, billing and balance operations are console only — they are closed to the API so that a leaked token cannot take over the account.
actions
GET/actions
Proje action listesi (son aktiviteler; started azalan)
per_pageidresource_typeresource_id
GET/actions/{id}
Action durumu (uzun işlemler bununla yoklanır)
datacenters
GET/datacenters
Veri merkezleri
firewalls
GET/firewalls
Güvenlik duvarları
name
POST/firewalls
Güvenlik duvarı oluştur
has request body
GET/firewalls/{id}
Güvenlik duvarı detayı
PUT/firewalls/{id}
Güvenlik duvarını yeniden adlandır
has request body
DELETE/firewalls/{id}
Güvenlik duvarını sil
POST/firewalls/{id}/actions/set_rules
Kuralları değiştir (tümünü değiştirir)
has request body
POST/firewalls/{id}/actions/apply_to_resources
Duvarı kaynaklara uygula
has request body
POST/firewalls/{id}/actions/remove_from_resources
Duvarı kaynaklardan kaldır
has request body
images
GET/images
İmajlar
namearchitecture
GET/images/{id}
İmaj detayı
id*
locations
GET/locations
Lokasyonlar
pricing
GET/pricing
Fiyat bilgisi (currency TRY, vat_rate 20.00, primary_ips)
primary_ips
GET/primary_ips
Primary IP'leri listele (hcloud uyumlu yüzey)
GET/primary_ips/{id}
Primary IP detayı
POST/primary_ips/{id}/actions/change_dns_ptr
rDNS (PTR) kaydını değiştir
has request body
server_types
GET/server_types
SKU listesi (TL fiyatlarla)
name
servers
POST/servers/{id}/actions/request_console
Tarayıcı konsolu (noVNC) — tek kullanımlık, kısa ömürlü URL döner
GET/servers
Sunucuları listele
POST/servers
Sunucu oluştur
has request body
GET/servers/{id}
Sunucu detayı
DELETE/servers/{id}
Sunucuyu sil (yumuşak silme; action döner)
GET/servers/{id}/metrics
Sunucu metrikleri (CPU, disk, ağ — zaman serisi)
type*startendstep
POST/servers/{id}/actions/rebuild
İmajdan sıfırla ve başlat (veri silinir)
has request body
POST/servers/{id}/actions/change_type
Rescale — sunucu tipini değiştir
has request body
POST/servers/{id}/actions/{cmd}
Güç aksiyonu
cmd*
ssh_keys
GET/ssh_keys
SSH anahtarları
name
POST/ssh_keys
SSH anahtarı ekle
has request body
GET/ssh_keys/{id}
SSH anahtarı detayı
DELETE/ssh_keys/{id}
SSH anahtarını sil
This list is generated automatically from the API contract — it updates itself on every release.