Update Post Generation Progress (v1)

n8n progress update endpoint for post generation jobs.

Method & Path

POST /v1/webhooks/jobs/n8n/update-product-marketing-post-generatorn-progress

Description

Progress update endpoint used by n8n workflows to send real-time progress updates during post generation. Updates the job metadata in the database and broadcasts progress via WebSocket to connected clients.

Authentication

None required - This is a callback endpoint from n8n.

Headers

Content-Type: application/json

Query Parameters

None.

Request Body

{
  "jobId": "507f1f77bcf86cd799439011",
  "status": "processing",
  "progress": 50,
  "step": "Generating images",
  "message": "Processing 2 of 4 posts",
  "meta": {
    "currentPost": 2,
    "totalPosts": 4
  }
}

Request Body Schema

Field	Type	Required	Description
jobId	string	Yes	The job ID (MongoDB ObjectId)
status	enum	Yes	Job status: processing, done, or failed
progress	number	Yes	Progress percentage (0-100)
step	string	Yes	Current step description
message	string	Yes	Progress message
meta	object	No	Additional metadata

Response 200 OK

{
  "success": true,
  "message": "Progress update received, saved to database and broadcasted"
}

Common Errors

• 400 Bad Request: Invalid progress update payload or invalid jobId format
• 404 Not Found: Job not found
• 500 Internal Server Error: Server error

note

This endpoint updates the job metadata in the database and emits WebSocket events to notify connected clients of progress updates in real-time.