Skip to content

Crear servidor​

POST
/v1/org/{org_id}/server

server.create — OWNER ADMIN

Devuelve el token de aprovisionamiento una sola vez.

Autorizaciones​

bearer

Token de servicio (kjtk_live_…), creado desde el panel en Ajustes → Tokens de servicio. Pertenece a una organización y lleva sus propios permisos.

Tipo
HTTP (bearer)
o
JWT

Sesión de una persona en el panel. No sirve para integrar.

Tipo
HTTP (bearer)

Parámetros​

Parámetros de la ruta

org_id*
Tipo
number
Requerido

Cuerpo de la petición​

application/json
JSON
{
  
"name": "hetzner-fra-01",
  
"description": "Main VPS in Frankfurt",
  
"ip": "49.12.44.201",
  
"os": "Debian 12",
  
"cpu": 8,
  
"ram_mb": 32768,
  
"default_agent_memory_mb": 4096,
  
"default_agent_cpu": 2,
  
"alerts_enabled": true,
  
"alert_ram_pct": 85,
  
"alert_cpu_pct": 90,
  
"alert_load_factor": 1.5
}

Respuestas​

application/json
JSON
{
  
"id": 1,
  
"organization_id": 1,
  
"name": "hetzner-fra-01",
  
"description": "string",
  
"ip": "49.12.44.201",
  
"os": "string",
  
"cpu": 0,
  
"ram_mb": 0,
  
"default_agent_memory_mb": 4096,
  
"default_agent_cpu": 2,
  
"status": "UNPROVISIONED",
  
"load": 0,
  
"cpu_percent": 0,
  
"ram_percent": 0,
  
"alerts_enabled": true,
  
"alert_ram_pct": 85,
  
"alert_cpu_pct": 90,
  
"alert_load_factor": 1.5,
  
"uptime_seconds": 0,
  
"last_seen_at": "string",
  
"provisioning_expires_at": "string",
  
"supervisor_outdated": false,
  
"agents_count": 3,
  
"has_ssh_key": true,
  
"provisioning_token": "string",
  
"created_at": "string",
  
"updated_at": "string"
}

Pruébalo​

Autorización
Variables
Clave
Valor
Cuerpo

Ejemplos​