Skip to Content
GrowSocialelion API
Drafts endpoints

Generate one series video (async)

Queue the render of ONE video part of an APPROVED series and return at once with a job_id: this call never waits for the video.

POST /api/v1/generate_video · MCP tool generate_video · scope drafts + spend

Queue the render of ONE video part of an APPROVED series and return at once with a job_id: this call never waits for the video. Poll get_video_status. Refuses a series nobody approved, a part that is not a video, a halted or over-budget brand, a workspace without credits, a part over the $3 per-video cap, and more than 30 renders per workspace per UTC day. Idempotent: a part already queued or rendered comes back with its job. Publishes nothing. Needs the key's 'drafts' and 'spend' scopes.

Scope. Save drafts, articles and series proposals to the Inbox, and withdraw your own drafts. Nothing publishes. Every call costs credits, so the key also needs spend.

Arguments

NameTypeRequiredDescription
series_idstringYesThe seriesId.
partinteger | stringYesThe part: its number (1, 2, ...) or its episode id (from get_series).

Request

curl -X POST https://growsocialelion.com/api/v1/generate_video \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"series_id":"ser_123","part":2}'

Response

200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.

{
  "status": "string",
  "reason": "string",
  "job_id": "string",
  "code": "string"
}

Errors use the shared body. See Errors. The full schema is in the API reference.