Deploy App

• Direct upload (application/gzip): send a gzipped tarball of your project directory — no agent container involved. This is what naive apps deploy does when run outside a container.
• Workspace deploy (JSON body or empty): copies code from the company’s agent container workspace (orchestrated mode).

# Direct mode: upload your local project (what `naive apps deploy` does for you)
tar czf app.tgz --exclude node_modules --exclude .next --exclude .git -C ./my-project .
curl -X POST https://api.usenaive.ai/v1/apps/ca7a1b8c-a4d4-4824-b92d-89d5b297eb62/deploy \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/gzip" \
  --data-binary @app.tgz

# Orchestrated mode: deploy from the agent container workspace
curl -X POST https://api.usenaive.ai/v1/apps/ca7a1b8c-a4d4-4824-b92d-89d5b297eb62/deploy \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "id": "deployment-uuid",
  "appId": "ca7a1b8c-a4d4-4824-b92d-89d5b297eb62",
  "vercelDeploymentId": "dpl_abc123xyz",
  "url": "https://naive-my-landing-page-ca7a1b-h7k2m.vercel.app",
  "status": "preview",
  "isProduction": false,
  "triggeredBy": "upload",
  "createdAt": "2026-01-15T12:00:00Z"
}

​

Direct Upload Mode

• Max 30 MB gzipped, max 200 MB decompressed, max 5,000 entries
• node_modules, .next, and .git are skipped server-side (exclude them client-side too for speed)
• Absolute paths and .. traversal entries are rejected
• The build system detects the framework and builds; pre-built static sites (index.html, no package.json) are served as-is

​

Workspace Deploy Mode (Orchestrated)

1. Explicit workspacePath — {workspacePath}/app is deployed.
2. Active task workspace — if a kanban task body references naive apps deploy <appId>, that task’s workspace is used.
3. Engineer agent workspace — {app.workspacePath}/app. If the workspace was never scaffolded, the starter template is applied automatically and the deploy retried once.

​

After the Deploy

​

Errors

{
  "error": {
    "code": "invalid_input",
    "message": "Upload too large (max 30MB). Exclude node_modules, .next, and .git."
  }
}

{
  "error": {
    "code": "invalid_input",
    "message": "This app has no workspace container — deploy directly from your project instead: clone the starter (...), build it, then run 'naive apps deploy <id>' from the project directory (or POST a gzipped tarball to this endpoint)."
  }
}

{
  "error": {
    "code": "feature_not_configured",
    "message": "No hosting project linked to this app"
  }
}