Skip to main content
GET
/
api
/
v1
/
projects
/
{projectId}
/
chapters
/
{chapterId}
Get Chapter
curl --request GET \
  --url https://api.example.com/api/v1/projects/{projectId}/chapters/{chapterId} \
  --header 'Authorization: <authorization>'
{
  "NOT_FOUND": {}
}

​
Overview

Retrieve complete details about a specific chapter, including all associated prompts and content.

​
Request

​
Path Parameters

​
projectId
string
required
The project ID
​
chapterId
string
required
The chapter ID

​
Headers

​
Authorization
string
required
Bearer token with your API key

​
Response

Returns the chapter object with all nested prompts and content.

​
Examples

curl https://api.babou.ai/api/v1/projects/prj_abc123xyz/chapters/cht_def456uvw \
  -H "Authorization: Bearer $BABOU_API_KEY"

​
Response Example

{
  "id": "cht_def456uvw",
  "project_id": "prj_abc123xyz",
  "name": "Introduction",
  "duration": 30,
  "created_at": "2025-12-02T10:01:00Z",
  "status": "ready",
  "prompt_count": 2,
  "prompts": [
    {
      "id": "int_abc123xyz789",
      "content": "Create an engaging introduction about AI video creation",
      "result": "Video content created successfully",
      "created_at": "2025-12-02T10:05:00Z"
    },
    {
      "id": "int_def456uvw012",
      "content": "Add smooth transitions between scenes",
      "result": null,
      "created_at": "2025-12-02T10:07:00Z"
    }
  ]
}
The result field in each prompt contains the result message from processing, or null if still processing. The chapter-level status field indicates the overall chapter state: ready, processing, or error.

​
Error Responses

​
NOT_FOUND
404
Chapter not found
{
  "error": "Chapter not found",
  "code": "NOT_FOUND"
}

​
Next Steps

Submit Prompt

Add video content to this chapter

List Chapters

View all chapters