POST /api/v1/projects/create

Create a Project

This page offers a clear overview of Create a Project. It helps you explore this topic and find a useful next step.

POST

https://vidbyte-backend.onrender.com/api/v1/projects/create

Example request

bash

curl https://vidbyte-backend.onrender.com/api/v1/projects/create \
  -H "x-api-key: vb_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Design a backend observability project",
    "project_goal": "Ship something portfolio-ready",
    "current_level": "intermediate",
    "depth_preference": "deep but practical"
  }'

Example response

JSON

{
  "success": true,
  "id": "proj_Mx1q8Tt2",
  "data": {
    "id": "proj_Mx1q8Tt2",
    "item_type": "project",
    "title": "Backend observability project",
    "status": "active",
    "createdAt": "2026-04-10T18:00:00",
    "updatedAt": "2026-04-10T18:00:00",
    "project_data": { "generation_status": "project_completed", "project_output": { "milestones": [] } }
  }
}

Parameter information

These are the public parameters for /api/v1/projects/create. Path parameters and request-body fields are shown together so the page stays focused on the live request contract you actually send.

promptstringRequired

The main topic, task, or learning objective you want Vidbyte to generate from. This is the core instruction the route uses.