Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/darkzOGx/youtube-automation-agent/llms.txt

Use this file to discover all available pages before exploring further.

Introduction

The YouTube Automation Agent provides a RESTful API for managing automated YouTube content creation, scheduling, and analytics. All endpoints are accessible via HTTP and return JSON responses.

Base URL

http://localhost:3456
The default port is 3456, but can be configured via the PORT environment variable.

Available Endpoints

The API provides the following endpoint groups:

Health & Status

  • GET /health - Check system health and agent status

Content Generation

  • POST /generate - Manually generate YouTube content

Publishing

  • POST /publish/:contentId - Manually publish content to YouTube

Scheduling

  • GET /schedule - Get upcoming content schedule

Analytics

  • GET /analytics - Retrieve recent analytics data

Response Format

All API responses are returned in JSON format.

Success Response

{
  "success": true,
  "result": { /* endpoint-specific data */ }
}

Error Response

{
  "success": false,
  "error": "Error message description"
}
For GET endpoints that don’t use the success/result wrapper, errors return:
{
  "error": "Error message description"
}

HTTP Status Codes

CodeDescription
200Success - Request completed successfully
500Server Error - An error occurred processing the request

Authentication

The current version does not implement authentication. This is suitable for local development and testing. For production deployments, implement proper authentication and authorization.

Rate Limiting

No rate limiting is currently implemented. The API is designed for internal use and automation.

Content Type

All POST requests should include the following header:
Content-Type: application/json

Next Steps

Explore the individual endpoint documentation:

Health Check

Monitor system status and agent availability

Generate Content

Create new YouTube content programmatically

Schedule

View upcoming content schedule

Analytics

Access performance metrics

Publish

Manually publish content to YouTube

Build docs developers (and LLMs) love