API Reference

Vesta’s API server exposes a RESTful API for all platform operations. All endpoints require authentication via Bearer token.

Authentication

curl -H "Authorization: Bearer <token>" https://<api-host>/api/v1/...

Endpoints

Apps

MethodPathDescription
GET/api/v1/appsList all apps
POST/api/v1/appsCreate a new app
GET/api/v1/apps/:idGet app details
PUT/api/v1/apps/:idUpdate an app
DELETE/api/v1/apps/:idDelete an app

Deployments

MethodPathDescription
POST/api/v1/apps/:id/deployDeploy an app
GET/api/v1/apps/:id/deploymentsList deployments

Deploy request body:

{
  "tag": "v1.2.3",
  "environment": "production"
}

Projects

MethodPathDescription
GET/api/v1/projectsList all projects
POST/api/v1/projectsCreate a new project
GET/api/v1/projects/:idGet project details
DELETE/api/v1/projects/:idDelete a project

Secrets

MethodPathDescription
GET/api/v1/secretsList all secrets
POST/api/v1/secretsCreate a new secret
DELETE/api/v1/secrets/:idDelete a secret

Auth

MethodPathDescription
POST/api/v1/auth/loginLogin and receive JWT
POST/api/v1/auth/registerRegister a new user
POST/api/v1/auth/forgot-passwordRequest password reset

Health

MethodPathDescription
GET/healthzHealth check endpoint