Projects

All endpoints require Authorization: Bearer TOKEN.

Create Project


POST /api/v1/projects

Body:


{
  "name": "my-app",
  "framework": "nextjs",
  "build_command": "npm run build",
  "start_command": "npm start",
  "port": 3000
}

Response: 201


{
  "id": "prj_abc123",
  "name": "my-app",
  "framework": "nextjs",
  "status": "created",
  "url": "my-app.app.espace-tech.com",
  "created_at": "2025-01-15T10:30:00Z"
}

List Projects


GET /api/v1/projects

Response: 200 — Array of projects.

Get Project


GET /api/v1/projects/:id

Update Project


PUT /api/v1/projects/:id

Body: Any fields from the create request.

Delete Project


DELETE /api/v1/projects/:id

Deleting a project removes all deployments, domains, and linked resources.

Get Project Logs


GET /api/v1/projects/:id/logs?lines=100

Parameter	Type	Default	Description
`lines`	`number`	`100`	Number of log lines to return

Get Project Metrics


GET /api/v1/projects/:id/metrics?period=24h

Parameter	Type	Default	Options
`period`	`string`	`24h`	`1h`, `24h`, `7d`, `30d`

Response: 200


{
  "cpu_usage": 0.15,
  "memory_usage": 128.5,
  "requests_total": 12450,
  "avg_latency_ms": 45
}