Services API

Manage and monitor services.

List Services

GET /api/v1/services

Query Parameters

Parameter	Type	Description
status	string	Filter by status (healthy, unhealthy, unknown)
type	string	Filter by type (docker, kubernetes, http)
page	integer	Page number (default: 1)
per_page	integer	Items per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "id": "svc_abc123",
      "name": "api-gateway",
      "type": "docker",
      "status": "healthy",
      "instances": 3,
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T12:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 45
  }
}

Get Service

GET /api/v1/services/:id

Response

{
  "data": {
    "id": "svc_abc123",
    "name": "api-gateway",
    "type": "docker",
    "status": "healthy",
    "instances": 3,
    "health_check": {
      "endpoint": "/health",
      "interval": "30s",
      "timeout": "5s"
    },
    "metrics": {
      "cpu_percent": 45.2,
      "memory_mb": 512,
      "requests_per_sec": 1250
    },
    "created_at": "2025-01-15T10:00:00Z"
  }
}

Create Service

POST /api/v1/services

Request Body

{
  "name": "my-service",
  "type": "http",
  "url": "https://my-service.example.com",
  "health_check": {
    "endpoint": "/health",
    "interval": "30s"
  }
}

Response

{
  "data": {
    "id": "svc_xyz789",
    "name": "my-service",
    "status": "unknown"
  }
}

Update Service

PATCH /api/v1/services/:id

Delete Service

DELETE /api/v1/services/:id

Returns 204 No Content on success.