Menu
https://generate.contentdrips.com
All endpoints (except /queue/stats) require Bearer token authentication.
Authorization: Bearer {your_token}
Content-Type: application/json| Method | Endpoint | Type | Description |
|---|---|---|---|
| POST | /render |
Async | Submit job to queue for processing |
| GET | /job/:jobId/status |
Async | Check job processing status |
| GET | /job/:jobId/result |
Async | Get completed job result |
| GET | /queue/stats |
Info | Get queue statistics |
| POST | /generate |
Sync | Original synchronous processing |
Submit a job to the processing queue for asynchronous handling.
POST /render
Authorization: Bearer {token}
Content-Type: application/json
{
"template_id": "123",
"output": "png",
"tool": "carousel-maker",
"branding": {
"name": "John Doe",
"handle": "@johndoe",
"bio": "Software Developer",
"website_url": "https://johndoe.com",
"avatar_image_url": "https://example.com/avatar.jpg"
},
"content_update": [
{ "type": "textbox", "label": "title", "value": "New Title Text" },
{ "type": "image", "label": "main_image", "value": "https://example.com/image.jpg" }
],
"carousel": [
{
"content_fields": [
{ "type": "textbox", "label": "slide_title", "value": "Slide 1 Title" }
]
}
]
}
Success Response (202 Accepted)
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "queued",
"message": "Job has been queued for processing",
"estimated_time": "2-5 minutes",
"check_status_url": "/job/5844c4b4-dd6d-4b60-8d0f-e3818043fb11/status"
}400 Bad Request
{
"error": "Validation error",
"message": "template_id is required"
}401 Unauthorized
{
"error": "Unauthorized",
"message": "Invalid or missing Bearer token"
}500 Internal Server Error
{
"error": "Failed to queue job",
"message": "Redis connection failed"
}Check the current status of a queued job
GET /job/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status
Queued
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "queued",
"updated_at": "2024-01-15T10:30:00.000Z",
"startedAt": null,
"progress": "Job is waiting in queue"
}Processing
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "queued",
"updated_at": "2024-01-15T10:30:00.000Z",
"startedAt": null,
"progress": "Job is waiting in queue"
}Completed
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "completed",
"updated_at": "2024-01-15T10:35:00.000Z",
"startedAt": "2024-01-15T10:32:00.000Z",
"progress": "Job completed successfully"
}Failed
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "failed",
"updated_at": "2024-01-15T10:33:00.000Z",
"startedAt": "2024-01-15T10:32:00.000Z",
"progress": "Error: Template not found",
"error_details": "Invalid template ID provided"
}404 Not Found
{
"error": "Job not found",
"job_id": "invalid-job-id"
}
GET /job/a1b2c3d4-e5f6-7890-abcd-ef1234567890/result
Job Result When Pending
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "processing",
"message": "Job not yet completed",
"check_again_in": "30 seconds"
}Carousel PNG Array
{
"date": "2024-01-15T10:35:00.000Z",
"type": "carousel",
"export_url": [
"https://your-bucket.s3.amazonaws.com/.../frame-0.png",
"https://your-bucket.s3.amazonaws.com/.../frame-1.png",
"https://your-bucket.s3.amazonaws.com/.../frame-2.png"
]
}Carousel PDF Array
{
"date": "2024-01-15T10:35:00.000Z",
"type": "carousel",
"export_url": "https://your-bucket.s3.amazonaws.com/.../carousel.pdf"
}Single Image
{
"date": "2024-01-15T10:35:00.000Z",
"type": "normal",
"export_url": "https://your-bucket.s3.amazonaws.com/.../template.png"
}
Job Failed
{
"job_id": "5844c4b4-dd6d-4b60-8d0f-e3818043fb11",
"status": "failed",
"message": "Template not found or processing error occurred",
"error_details": "Invalid template ID provided"
}Direct synchronous image/PDF generation.
POST /generate
Authorization: Bearer {token}
Content-Type: application/json
{
"template_id": "123",
"output": "png"
}
Get real-time statistics on the job queue.
GET /queue/stats
| Parameter | Type | Description |
|---|---|---|
template_id |
string | Required. Unique identifier for the template |
output |
string | Optional. "png" (default) or "pdf" |
tool |
string | Optional. "carousel-maker" or blank |
branding |
object | Optional. Branding information (name, handle, etc) |
content_update |
array | Optional. Content updates (textbox/image) |
carousel |
array | Optional. Carousel slides, each with content_fields |
All errors follow this format:
{
"error": "Error Type",
"message": "Detailed error description",
"type": "ErrorClassName" // optional
}| Code | Description |
|---|---|
| 200 | Success (synchronous) |
| 202 | Accepted (async job queued) |
| 400 | Bad Request (validation error) |
| 401 | Unauthorized (invalid token) |
| 404 | Not Found (job/template) |
| 408 | Request Timeout |
| 500 | Internal Server Error |
/render` endpoint uses job queue; no direct client-side rate limit.server/{profile_id}/uploads/`.1. Submit Job
curl -X POST https://generate.contentdrips.com/render \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{"template_id": "123", "output": "png"}'
2. Check Status
curl https://generate.contentdrips.com/job/{job_id}/status3. Get Result
curl https://generate.contentdrips.com/job/{job_id}/result1. Direct Processing
curl -X POST https://generate.contentdrips.com/generate \
-H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-d '{"template_id": "123", "output": "png"}'GET /queue/stats`In AWS S3, organized by profile ID.
Poll /job/:jobId/status until you get "completed".
Error details are returned in responses. See “Error Handling” above.