Error reference

Schedule API errors come from two layers.

1. Edge validation (`422`)

Request-shape checks run at the Embed API before forwarding. They return:


{ "status": false, "message": "<reason>" }

Message	Endpoint(s)
`Token is required for this call.`	all (missing key header)
`Extra parameters passed in the body.`	create, update
`Status is required`	create, update
`Status must be 'DRAFT' or 'SCHEDULED'`	create, update
`Scheduled at is required`	create, update
`Scheduled at must be a string`	create, update
`Scheduled at is not a valid date`	create, update
`Design id must be a string`	create, update
`Post content must be an object`	create, update
`Selected accounts must be an array`	create, update
`Instagram post settings must be an object`	create, update
`TikTok post settings must be an object`	create, update
`LinkedIn post settings must be an object`	create, update
`Threads post settings must be an object`	create, update
`Post settings must be an object`	create, update
`Post id is required`	get, update, delete
`From date is required` / `From date is not a valid date`	list
`To date is required` / `To date is not a valid date`	list


{ "status": false, "message": "<reason>" }

Status	Message
`401`	`Unauthorized` (no key)
`401`	`Unable to find embed details, please check your Embed API key and make sure to use the key for API.`
`401`	`Unable to find workspace details, please attach a workspace to this API key.`
`401`	`Unable to find organization details.`
`402`	`Embed API requires a paid main plan with the API Credits add-on, or an active Embed API subscription.`

These preserve the upstream status code where available (otherwise 500):


{
  "success": false,
  "message": "<reason>",
  "error": { /* upstream details, or the message string */ }
}

Workspace not found.
Scheduled at is required
Design not found. — designId set but not found in your workspace
Invalid post status
Post content must be an object / Post content is empty / Post content must have 'common' key or at least one platform-specific key (...)
Either designId or postContent must be provided. ...
Selected accounts must be an array
Social account(s) not found or do not belong to this workspace: <ids>
Scheduled at must be a string / Scheduled at is not a valid date / Scheduled at is in the past