Servers API

GET    /api/v1/servers              # List
POST   /api/v1/servers              # Create
GET    /api/v1/servers/{id}         # Get
PUT    /api/v1/servers/{id}         # Update
DELETE /api/v1/servers/{id}         # Delete
POST   /api/v1/servers/{id}/start   # Start
POST   /api/v1/servers/{id}/stop    # Stop
POST   /api/v1/servers/{id}/reboot  # Reboot
GET    /api/v1/servers/{id}/metrics # Metrics

Usage Notes

  • Create operations depend on the provider type and often require a region and instance size.
  • BYOS-connected servers appear in the same API surface as provider-managed servers.
  • Metrics and terminal-related features depend on the agent being connected.

Example

curl -X POST https://api.docka.dev/api/v1/servers \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "edge-fr-1",
    "provider_id": "provider-uuid",
    "region": "nbg1",
    "size": "cx21"
  }'