Cosmoner Docs
API Reference

Servers

Provision and manage servers with cost previews and Stripe billing integration.

List Servers

GET /v1/projects/:projectId/servers

Returns servers in the project.

Auth: Required (member, scope: servers:read)


Preview Cost

GET /v1/projects/:projectId/servers/preview?provider=<provider>&slug=<slug>

Returns a prorated cost preview for provisioning a server, including the subtotal, estimated tax, any applied credit, and the total due today.

Auth: Required (member)


Create Server

POST /v1/projects/:projectId/servers

Provisions a new server. The prorated amount is charged to the project's payment method off-session and the response is { deployed: true }. If the project has no card, the request returns 402 — see Billing → Deploy Payment Errors.

Auth: Required (member, write access, scope: servers:write)


Delete Server

DELETE /v1/projects/:projectId/servers

Returns 403 — server deletion is not supported via the control panel.

Auth: Required (member, write access, scope: servers:write)

On this page