API Reference

Create an API key from Settings → API Keys. Pass it as a header:

Authorization: Bearer mb_live_...

API keys have 'deploy' scope by default, allowing programmatic deployments.

POST /api/projects/upload/stream

Content-Type: multipart/form-data

Authorization: Bearer mb_live_...

Form fields:

file: your project ZIP (required)

redeployProjectId: existing mission ID, to deploy a new version to it (optional — omit to create a new mission)

name: mission name, for new missions only (optional)

Response: text/event-stream (Server-Sent Events) — progress events stream as the deploy runs, ending in a deploy_success or deploy_failed event carrying the deploymentId. There's no separate status-polling endpoint today; keep the connection open and read the stream to completion (see the GitHub Actions example below for a curl invocation that works with this).