HepCloud API

openapi: 3.1.0
info:
  title: HepCloud API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 47 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; HepCloud has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 46
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.hepcloud.net/en/api
  - https://docs.hepcloud.net/tr/api
servers:
- url: https://api.hepcloud.net/v1
paths:
  /actions:
    get:
      operationId: get_actions
      tags:
      - Actions
      summary: Proje action listesi (son aktiviteler; started azalan)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: per_page
        in: query
        required: false
        schema:
          type: integer
      - name: id
        in: query
        required: false
        schema:
          type: integer
      - name: resource_type
        in: query
        required: false
        schema:
          type: string
      - name: resource_id
        in: query
        required: false
        schema:
          type: integer
      - name: hide_routine
        in: query
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /actions/{id}:
    get:
      operationId: get_actions_id
      tags:
      - Actions
      summary: Action durumu (uzun işlemler bununla yoklanır)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /database_types:
    get:
      operationId: get_database_types
      tags:
      - Database Types
      summary: Veritabanı paketleri
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases:
    get:
      operationId: get_databases
      tags:
      - Databases
      summary: Veritabanları
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_databases
      tags:
      - Databases
      summary: Veritabanı oluştur
      x-source: https://docs.hepcloud.net/en/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDatabasesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}:
    delete:
      operationId: delete_databases_id
      tags:
      - Databases
      summary: Veritabanını sil
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_databases_id
      tags:
      - Databases
      summary: Veritabanı detayı + bağlantı dizesi
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/actions/change_type:
    post:
      operationId: post_databases_id_actions_change_type
      tags:
      - Databases
      summary: Veritabanı paketini değiştir
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDatabasesIdActionsChangeTypeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/actions/restore:
    post:
      operationId: post_databases_id_actions_restore
      tags:
      - Databases
      summary: Yedekten geri yükle
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDatabasesIdActionsRestoreRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/actions/restore-to-time:
    post:
      operationId: post_databases_id_actions_restore_to_time
      tags:
      - Databases
      summary: Zamana geri yükle
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDatabasesIdActionsRestoreToTimeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/backups:
    get:
      operationId: get_databases_id_backups
      tags:
      - Databases
      summary: Veritabanının yedeklerini listele
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/metrics:
    get:
      operationId: get_databases_id_metrics
      tags:
      - Databases
      summary: Veritabanı metrikleri
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: hours
        in: query
        required: false
        schema:
          type: string
        description: Saat dilimi
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/pitr-window:
    get:
      operationId: get_databases_id_pitr_window
      tags:
      - Databases
      summary: Zamana geri yükleme penceresi
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /databases/{id}/slow-queries:
    get:
      operationId: get_databases_id_slow_queries
      tags:
      - Databases
      summary: En çok zaman harcayan sorgular
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /datacenters:
    get:
      operationId: get_datacenters
      tags:
      - Datacenters
      summary: Veri merkezleri
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /firewalls:
    get:
      operationId: get_firewalls
      tags:
      - Firewalls
      summary: Güvenlik duvarları
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_firewalls
      tags:
      - Firewalls
      summary: Güvenlik duvarı oluştur
      x-source: https://docs.hepcloud.net/en/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFirewallsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /firewalls/{id}:
    delete:
      operationId: delete_firewalls_id
      tags:
      - Firewalls
      summary: Güvenlik duvarını sil
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_firewalls_id
      tags:
      - Firewalls
      summary: Güvenlik duvarı detayı
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_firewalls_id
      tags:
      - Firewalls
      summary: Güvenlik duvarını yeniden adlandır
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutFirewallsIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /firewalls/{id}/actions/apply_to_resources:
    post:
      operationId: post_firewalls_id_actions_apply_to_resources
      tags:
      - Firewalls
      summary: Duvarı kaynaklara uygula
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFirewallsIdActionsApplyToResourcesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /firewalls/{id}/actions/remove_from_resources:
    post:
      operationId: post_firewalls_id_actions_remove_from_resources
      tags:
      - Firewalls
      summary: Duvarı kaynaklardan kaldır
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFirewallsIdActionsRemoveFromResourcesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /firewalls/{id}/actions/set_rules:
    post:
      operationId: post_firewalls_id_actions_set_rules
      tags:
      - Firewalls
      summary: Kuralları değiştir (tümünü değiştirir)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFirewallsIdActionsSetRulesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /images:
    get:
      operationId: get_images
      tags:
      - Images
      summary: İmajlar
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetImagesResponse'
      x-evidence:
        kind: documentation
  /images/{id}:
    get:
      operationId: get_images_id
      tags:
      - Images
      summary: İmaj detayı
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /invoices:
    get:
      operationId: get_invoices
      tags:
      - Invoices
      summary: Hesabın tüketim faturaları (ay sonu kesilir; prepaid modelde ödeme talebi değil belgedir)
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /invoices/{id}:
    get:
      operationId: get_invoices_id
      tags:
      - Invoices
      summary: Tek fatura + kalem dökümü
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /locations:
    get:
      operationId: get_locations
      tags:
      - Locations
      summary: Lokasyonlar
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/authorize:
    get:
      operationId: get_oauth_authorize
      tags:
      - Oauth
      summary: Yetkilendirme isteği (tarayıcıdan)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: response_type
        in: query
        required: false
        schema:
          type: string
      - name: client_id
        in: query
        required: false
        schema:
          type: string
      - name: redirect_uri
        in: query
        required: false
        schema:
          type: string
      - name: code_challenge
        in: query
        required: false
        schema:
          type: string
      - name: code_challenge_method
        in: query
        required: false
        schema:
          type: string
      - name: state
        in: query
        required: false
        schema:
          type: string
      - name: scope
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/register:
    post:
      operationId: post_oauth_register
      tags:
      - Oauth
      summary: Dinamik istemci kaydı (RFC 7591)
      x-source: https://docs.hepcloud.net/en/api
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOauthRegisterRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: Kod ya da yenileme token'ını erişim token'ına çevirir
      x-source: https://docs.hepcloud.net/en/api
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOauthTokenRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /pricing:
    get:
      operationId: get_pricing
      tags:
      - Pricing
      summary: Fiyat bilgisi (currency TRY, vat_rate 20.00, primary_ips)
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /primary_ips:
    get:
      operationId: get_primary_ips
      tags:
      - Primary Ips
      summary: Primary IP'leri listele (hcloud uyumlu yüzey)
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /primary_ips/{id}:
    get:
      operationId: get_primary_ips_id
      tags:
      - Primary Ips
      summary: Primary IP detayı
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /primary_ips/{id}/actions/change_dns_ptr:
    post:
      operationId: post_primary_ips_id_actions_change_dns_ptr
      tags:
      - Primary Ips
      summary: rDNS (PTR) kaydını değiştir
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostPrimaryIpsIdActionsChangeDnsPtrRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /server_types:
    get:
      operationId: get_server_types
      tags:
      - Server Types
      summary: SKU listesi (TL fiyatlarla)
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers:
    get:
      operationId: get_servers
      tags:
      - Servers
      summary: Sunucuları listele
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_servers
      tags:
      - Servers
      summary: Sunucu oluştur
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers/{id}:
    delete:
      operationId: delete_servers_id
      tags:
      - Servers
      summary: Sunucuyu sil (yumuşak silme; action döner)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_servers_id
      tags:
      - Servers
      summary: Sunucu detayı
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers/{id}/actions/{cmd}:
    post:
      operationId: post_servers_id_actions_cmd
      tags:
      - Servers
      summary: Güç aksiyonu
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: cmd
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers/{id}/metrics:
    get:
      operationId: get_servers_id_metrics
      tags:
      - Servers
      summary: Sunucu metrikleri (CPU, disk, ağ — zaman serisi)
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: type
        in: query
        required: false
        schema:
          type: string
      - name: start
        in: query
        required: false
        schema:
          type: string
      - name: end
        in: query
        required: false
        schema:
          type: string
      - name: step
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ssh_keys:
    get:
      operationId: get_ssh_keys
      tags:
      - Ssh Keys
      summary: SSH anahtarları
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_ssh_keys
      tags:
      - Ssh Keys
      summary: SSH anahtarı ekle
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ssh_keys/{id}:
    delete:
      operationId: delete_ssh_keys_id
      tags:
      - Ssh Keys
      summary: SSH anahtarını sil
      description: SSH anahtarını sil
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_ssh_keys_id
      tags:
      - Ssh Keys
      summary: SSH anahtarı detayı
      x-source: https://docs.hepcloud.net/en/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/servers:
    get:
      operationId: get_v1_servers
      tags:
      - Servers
      summary: GET /v1/servers
      x-source: https://docs.hepcloud.net/en/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Authorization: Bearer <token>\" https://api.hepcloud.net/v1/servers\n Tokens are scoped to a project and are created\
          \ with either read-only or\nread-write permission. A read-only token receives a token_readonly error\non write requests. \n Tools \n\
          \ The hcloud command line tool and the Terraform provider work as they are\nonce you change the endpoint. Setup, environment variables\
          \ and a worked\nexam"
components:
  schemas:
    PostDatabasesRequest:
      type: object
      properties:
        has request body:
          type: string
      required:
      - has request body
    PostDatabasesIdActionsChangeTypeRequest:
      type: object
      properties:
        has request body:
          type: string
      required:
      - has request body
    PostDatabasesIdActionsRestoreRequest:
      type: object
      properties:
        has request body:
          type: string
      required:
      - has request body
    PostDatabasesIdActionsRestoreToTimeRequest:
      type: object
      properties:
        has request body:
          type: string
      required:
      - has request body
    PostFirewallsRequest:
      type: object
      properties:
        body:
          type: string
          description: Request body
      required:
      - body
    PutFirewallsIdRequest:
      type: object
      properties:
        body:
          type: string
          description: Request body
      required:
      - body
    PostFirewallsIdActionsApplyToResourcesRequest:
      type: object
      properties:
        body:
          type: string
          description: Request body
      required:
      - body
    PostFirewallsIdActionsRemoveFromResourcesRequest:
      type: object
      properties:
        body:
          type: string
          description: Request body
      required:
      - body
    PostFirewallsIdActionsSetRulesRequest:
      type: object
      properties:
        body:
          type: string
          description: Request body
      required:
      - body
    GetImagesResponse:
      type: object
      properties:
        name:
          type: string
          description: İmaj adı
        architecture:
          type: string
          description: Mimari
    PostOauthRegisterRequest:
      type: object
      properties:
        has request body:
          type: string
    PostOauthTokenRequest:
      type: object
      properties:
        has request body:
          type: string
    PostPrimaryIpsIdActionsChangeDnsPtrRequest:
      type: object
      properties:
        has request body:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Actions
- name: Database Types
- name: Databases
- name: Datacenters
- name: Firewalls
- name: Images
- name: Invoices
- name: Locations
- name: Oauth
- name: Pricing
- name: Primary Ips
- name: Server Types
- name: Servers
- name: Ssh Keys