Skip to main content
curl https://api.usenaive.ai/v1/apps/094cdfb5-c4dc-494d-91dc-8a0c1c3e94c2 \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "id": "094cdfb5-c4dc-494d-91dc-8a0c1c3e94c2",
  "name": "StudyAI",
  "type": "fullstack",
  "status": "active",
  "companyId": "company-uuid",
  "description": "AI study assistant",
  "workspacePath": "agents/agent-uuid",
  "agentId": "agent-uuid",
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:05:00Z",
  "vercel": {
    "vercelProjectId": "prj_5B9xCYfqFR15VTfvARu2ZgaXuA4u",
    "vercelProjectName": "naive-studyai-094cdf",
    "vercelTeamId": "team_abc123",
    "productionDomain": "naive-studyai-094cdf.vercel.app",
    "latestDeploymentUrl": "https://naive-studyai-094cdf-xyz.vercel.app",
    "latestDeploymentId": "dpl_xyz789",
    "latestDeploymentStatus": "production"
  },
  "supabase": {
    "projectRef": "abcdefghijklmnop",
    "url": "https://abcdefghijklmnop.supabase.co",
    "region": "us-east-1"
  },
  "template": {
    "repoUrl": "https://github.com/usenaive/app-dev-templates",
    "path": "fullstack/saas-dashboard",
    "variant": "saas-dashboard",
    "cloneCommand": "git clone https://github.com/usenaive/app-dev-templates naive-app && cd naive-app/fullstack/saas-dashboard"
  },
  "secrets": [
    { "id": "secret-uuid", "key": "NEXT_PUBLIC_SUPABASE_URL", "target": "production", "createdAt": "2026-01-15T10:03:00Z" }
  ],
  "domains": [
    { "id": "domain-uuid", "domain": "studyai.com", "type": "company", "verified": true, "isPrimary": true }
  ],
  "deployments": [
    { "id": "deployment-uuid", "vercelDeploymentId": "dpl_xyz789", "url": "https://naive-studyai-094cdf-xyz.vercel.app", "status": "production", "isProduction": true, "createdAt": "2026-01-15T11:00:00Z" }
  ]
}

​
Response Fields

FieldTypeDescription
idstringApp UUID
namestringDisplay name
typestringfrontend_only or fullstack
statusstringprovisioning, active, paused, error
workspacePathstringEngineer agent workspace where the app code lives
agentIdstring | nullDedicated engineer agent
vercelobject | nullVercel project link
vercel.productionDomainstringDomain that publish aliases to (defaults to {projectName}.vercel.app, or the primary custom domain)
supabaseobject | nullSupabase project link (fullstack only; null while provisioning)
supabase.projectRefstringSupabase project ref — used in Supabase proxy paths
templateobjectStarter template for this app type — repo URL, path, and clone command (templates)
secretsarrayEnvironment variable keys (values never included)
domainsarrayAttached domains
deploymentsarrayDeployment history, newest first
For fullstack apps, supabase stays null until background provisioning completes (typically 1–2 minutes). Poll this endpoint after creation.

​
Errors

404
{
  "error": {
    "code": "resource_not_found",
    "message": "App not found"
  }
}