POST /api/v1/roadmaps/create

Create a Roadmap

Create a new roadmap with learner context, pacing, and resource preferences. The response includes the encrypted public id plus the generated roadmap structure.

POST
https://api.vidbyte.pro/api/v1/roadmaps/create

Example request

bash
curl https://api.vidbyte.pro/api/v1/roadmaps/create \ -H "x-api-key: vb_live_your_api_key" \ -H "Idempotency-Key: roadmap-create-001" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Build a backend API platform roadmap", "experience": "intermediate", "timeline": "8 weeks", "resource_preference": "reading and docs" }'

Example response

JSON
{ "success": true, "encrypted_id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301", "message": "Roadmap created successfully.", "data": { "encrypted_id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301", "title": "", "modules": [{ "title": "API fundamentals", "resources": [{ "title": "Design a versioned contract", "type": "reading" }] }], "course_summary": "A phased roadmap for designing and shipping an API platform.", "course_outcomes": ["Ship a public API contract", "Understand auth and usage accounting"], "course_audio_script": "Module 1 introduces the contract, auth boundary, and usage model." }, "token_stats": { "input_tokens": 611, "output_tokens": 941, "total_tokens": 1552 }, "pricing": { "total_cost": 0.0241, "num_searches": 0 }, "object": "roadmap" }

Parameter information

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

promptstringRequired

Describe the skill, domain, or curriculum outcome you want the roadmap to organize into a learning plan.