Projects and deployments API

Deploy source

POST /projects/spacedrop This endpoint uses multipart/form-data.

zip file

required

Project source archive.

string

required

New project name. Optional when projectId is supplied.

string

required

Pxxl domain suffix for a new project, such as pxxl.pro.

string

Existing project that receives the deployment.

string

default:"production"

Deployment environment.

number

Port exposed by a web service.

string

Project root inside a monorepo.

string

Custom dependency installation command.

string

Custom build command.

string

Custom runtime command.

curl https://server.pxxl.app/api/v3/projects/spacedrop \
  --header "Authorization: Bearer $PXXL_API_KEY" \
  --form "file=@project.zip" \
  --form "name=api" \
  --form "domainChoice=pxxl.pro" \
  --form "port=3000" \
  --form "startCommand=npm start"

Response

{
  "success": true,
  "projectId": "proj_123",
  "deploymentId": "dep_123",
  "projectUrl": "https://api.pxxl.pro",
  "status": "queued",
  "taskId": "task_123"
}

Projects

Method	Path	Parameters	Returns
`GET`	`/cli/projects`	`teamId?`, `page?`, `limit?`	Project collection and pagination
`GET`	`/cli/projects/{projectId}`	Project ID	Project detail
`GET`	`/cli/projects/{projectId}/deployments`	`page?`, `limit?`, `teamId?`	Project deployments
`GET`	`/cli/projects/{projectId}/logs`	`lines?`, `since?`	Runtime logs
`GET`	`/cli/projects/{projectId}/live-logs`	`tail?`, `since?`	Recent live logs
`POST`	`/cli/projects/{projectId}/redeploy`	`commitSha?`, `commitMessage?`	New deployment result

{
  "projects": [
    {
      "id": "proj_123",
      "name": "api",
      "status": "active",
      "projectType": "web_service",
      "framework": "express",
      "language": "node"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

Redeploy

curl --request POST \
  https://server.pxxl.app/api/v3/cli/projects/proj_123/redeploy \
  --header "Authorization: Bearer $PXXL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"commitSha":"9868bbc","commitMessage":"Deploy release"}'

{
  "success": true,
  "projectId": "proj_123",
  "deploymentId": "dep_124",
  "status": "queued"
}

Deployments and logs

Method	Path	Parameters	Returns
`GET`	`/cli/deployments`	`teamId?`, `page?`, `limit?`	Deployment collection
`GET`	`/cli/deployments/{deploymentId}`	Deployment ID	Deployment detail
`GET`	`/cli/deployments/{deploymentId}/logs`	`since?`	Runtime log collection
`GET`	`/cli/deployments/{deploymentId}/build-logs`	`since?`	Build phase logs

{
  "deploymentId": "dep_123",
  "status": "building",
  "logs": [
    {
      "phase": "install",
      "message": "Installing dependencies",
      "timestamp": "2026-08-17T08:01:00Z"
    }
  ]
}

User-facing build logs come from /cli/deployments/{deploymentId}/build-logs.

SDK

CLI

API

Projects and deployments API

Deploy source

Projects

Redeploy

Deployments and logs

​Deploy source

​Projects

​Redeploy

​Deployments and logs

Deploy source

Projects

Redeploy

Deployments and logs