Skip to main content
GET
/
api
/
v1
/
projects
/
{projectId}
/
chapters
/
{chapterId}
{
  "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