Docs

API Reference

The VIERCE REST API lets you manage projects, deployments, and environment variables programmatically.

Base URL

https://api.vierce.dev

GET/v1/projects

List all projects for the authenticated account.

Auth: Bearer token

Response

{ "projects": [{ "id": "prj_xxx", "name": "my-project", "status": "active" }] }

POST/v1/projects

Create a new project.

Auth: Bearer token

Request Body

{ "name": "my-project", "framework": "nextjs" }

Response

{ "id": "prj_xxx", "name": "my-project", "status": "creating" }

GET/v1/deployments

List deployments for a project.

Auth: Bearer token

Response

{ "deployments": [{ "id": "dpl_xxx", "status": "ready", "url": "..." }] }

POST/v1/deployments

Trigger a new deployment.

Auth: Bearer token

Request Body

{ "projectId": "prj_xxx", "branch": "main" }

Response

{ "id": "dpl_xxx", "status": "building", "url": "https://..." }

GET/v1/environments

List environment variables for a project.

Auth: Bearer token

Response

{ "variables": [{ "key": "DATABASE_URL", "value": "postgres://..." }] }

POST/v1/environments

Set an environment variable.

Auth: Bearer token

Request Body

{ "projectId": "prj_xxx", "key": "DATABASE_URL", "value": "postgres://..." }

Response

{ "success": true }