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.
Success Response (202 Accepted)
400 Bad Request
401 Unauthorized
500 Internal Server Error
Check the current status of a queued job
Queued
Processing
Completed
Failed
404 Not Found
Single Image
Carousel Images
PDF Result
Job Not Ready
404 Not Found
404 Result Not Found
408 Request Timeout
500 Processing Error
500 Template Error
500 Canvas Error
Direct synchronous image/PDF generation.
Get real-time statistics on the job queue.
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:
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
2. Check Status
3. Get Result
1. Direct Processing
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.