{"openapi":"3.1.0","info":{"title":"Servera Developers API","description":"Manage your Servera services programmatically — starting with **VDS / VPS\nmanagement**: everything you can do in the customer area (power actions, status,\nsnapshots, backups, reinstall, live metrics).\n\n### Base URL\n```\nhttps://developers.servera.lt\n```\n\n### Quick start\n```bash\ncurl https://developers.servera.lt/v1/status\n```\n\n### Authentication\nCreate a scoped API key in your customer area (**Developers → API keys**), then\nsend it as a bearer token:\n```\nAuthorization: Bearer sk_live_…\n```\nKeys are shown once at creation and can be revoked anytime. Scopes:\n`vps:read` (view), `vps:power` (start/stop/reboot). A key with no scopes has full\naccess to your account's resources.\n\n### For AI agents\nAn AI-native **MCP** endpoint is planned so assistants like Claude can call the\nsame actions as tools — the surface below is the single source of truth it\nbuilds on.\n\n_This reference always reflects the live API. New endpoints appear here\nautomatically as they ship._\n","version":"1.0.0"},"servers":[{"url":"/dev"},{"url":"https://developers.servera.lt","description":"Production"}],"paths":{"/v1/status":{"get":{"tags":["meta"],"summary":"API status","description":"Liveness + version of the Developers API. No authentication required.","operationId":"get_status","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me":{"get":{"tags":["meta"],"summary":"Who am I","description":"Return the account this API key authenticates as. Handy for verifying a key.","operationId":"get_me","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKey":[]}]}},"/v1/vps":{"get":{"tags":["vps"],"summary":"List your VPS/VDS","description":"List every VPS/VDS on your account (Proxmox virtual machines you own).","operationId":"list_vps","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VpsSummary"},"type":"array","title":"Response List Vps"}}}}},"security":[{"ApiKey":[]}]}},"/v1/vps/{service_id}":{"get":{"tags":["vps"],"summary":"Get VPS status","description":"Live power state + resource usage for one VPS/VDS you own, from the hypervisor.","operationId":"get_vps","security":[{"ApiKey":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"integer","title":"Service Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vps/{service_id}/power":{"post":{"tags":["vps"],"summary":"Power action","description":"Start, stop (force), shutdown (ACPI), or reboot a VPS/VDS you own.\n\nFor QEMU VMs `reboot` performs a hard reset (cloud images ship without the\nguest agent an ACPI reboot needs).","operationId":"vps_power","security":[{"ApiKey":[]}],"parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"integer","title":"Service Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PowerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PowerRequest":{"properties":{"action":{"type":"string","enum":["start","stop","shutdown","reboot"],"title":"Action"}},"type":"object","required":["action"],"title":"PowerRequest","example":{"action":"reboot"}},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VpsSummary":{"properties":{"id":{"type":"integer","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"vmid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vmid"},"type":{"type":"string","title":"Type"},"node":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Node"},"status":{"type":"string","title":"Status"},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"ip_addresses":{"items":{"type":"string"},"type":"array","title":"Ip Addresses","default":[]},"next_due_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Due Date"}},"type":"object","required":["id","type","status"],"title":"VpsSummary"}},"securitySchemes":{"ApiKey":{"type":"http","description":"Your `sk_live_…` API key, sent as `Authorization: Bearer <key>`.","scheme":"bearer"}}},"tags":[{"name":"meta","description":"Service metadata and health."},{"name":"vps","description":"VDS / VPS management (coming online)."}]}