Plans API (provisional) - Hostifer Documentation

This module has typed DTOs and database-backed behavior, but treat the public contract as provisional while the API surface is being stabilized.

Endpoints

POST /plans
GET /plans
GET /plans/:id
PATCH /plans/:id
DELETE /plans/:id

Request contract

Create body

name (string)
tier (FREE, STARTER, PRO, ENTERPRISE)
maxProjects (int)
maxDeployments (int)
maxMemoryMi (int)
maxCpuM (int)
maxStorageGi (int)
maxBandwidthGb (int)
buildTimeoutMins (int)
customDomains, teamMembers, priorityBuilds (optional boolean)

Update body

PATCH /plans/:id accepts a partial subset of create fields.

Response contract

The service uses Prisma-backed entities for list, read, create, update, and delete.

curl -X POST http://localhost:3000/plans \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Free",
    "tier": "FREE",
    "maxProjects": 3,
    "maxDeployments": 10,
    "maxMemoryMi": 512,
    "maxCpuM": 500,
    "maxStorageGi": 1,
    "maxBandwidthGb": 10,
    "buildTimeoutMins": 15
  }'