Schedule an approved series
Set the publish schedule of an APPROVED series in one call: part 1 at startAt, then one part every everyHours, on the platforms you name per kind.
POST /api/v1/schedule_series · MCP tool schedule_series · scope schedule
Set the publish schedule of an APPROVED series in one call: part 1 at startAt, then one part every everyHours, on the platforms you name per kind. Also plans a 'Part N+1 is live' comment on each part where the network's API allows comments on our own post (YouTube, Instagram, Bluesky, X, Threads, Mastodon); others are listed as unsupported with the reason. Omit `platforms` to use the networks stored on the series. A network that is not connected, needs attention or cannot take that kind of part is refused with a sentence and nothing is scheduled. Every post and article part, and every rendered video, then becomes a draft in the Inbox with its time. Refuses a series a human has not approved. Needs the key's 'schedule' scope.
Scope. Set the schedule of a series a person already approved in the app. This endpoint never costs credits.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
seriesId | string | Yes | From propose_series. |
startAt | string | Yes | ISO date-time of part 1. |
everyHours | integer | No | Hours between parts. |
platforms | object | No | Where each kind goes, e.g. {video:['youtube','instagram'], article:['devdotto']}. Omitted = the networks stored on the series (the agent's proposal, as the person changed it). |
comments | boolean | No | Plan a 'Part N+1 is live' comment on each part where the network allows it. Default: on. |
Request
curl -X POST https://growsocialelion.com/api/v1/schedule_series \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"seriesId":"string","startAt":"2026-11-20T09:00:00.000Z"}'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",
"seriesId": "string"
}Errors use the shared body. See Errors. The full schema is in the API reference.