FoxCuePublishing API: Drafts, Thumbnails and YouTube Delivery
Prepare a FoxCue publishing draft, generate title and thumbnail text, and queue a YouTube upload with publishing:read, publishing:write and publishing:publish.
The publishing API prepares one finished output and then queues an explicit YouTube upload. Writes run only when native publishing is enabled on that server. If it is not, the app shows that YouTube uploads are not available right now. Do not treat a successful read of capabilities as a promise that upload is on.
Cancelling a delivery clears a native schedule. It does not delete a video that is already on YouTube.
Scopes
| Scope | Allows |
|---|---|
publishing:read | Read capabilities, draft context, thumbnail candidates and deliveries |
publishing:write | Create and edit a draft, generate metadata and thumbnails |
publishing:publish | Submit a reviewed draft, cancel or retry a delivery |
Metadata generation also requires publishing:read. Thumbnail generation requires publishing:read as well as publishing:write.
How a publish runs
GET /publishing/capabilitiesfor the brand. This does not upload anything.POST /publishing/draftswith a completed output from the same brand.- Edit the draft with
PATCH /publishing/drafts/{id}and its current revision. This never publishes. - Optional:
POST /publishing/drafts/{id}/metadata-generationsfor a title, description, tags and thumbnail headline, andPOST /publishing/drafts/{id}/thumbnailsfor one thumbnail. Read the receipt instead of calling the model again. POST /publishing/drafts/{id}/submitapproves that exact draft and queues the upload.- Poll
GET /publishing/deliveries/{id}for progress and the confirmed URL.
POST /publishing/deliveries/{id}/cancel stops a delivery. POST /publishing/deliveries/{id}/retry repairs or reapproves one while keeping the provider identity.
In the app, connect the channel from YouTube performance and Brand → Websites & Channels. Publishing appears when it is enabled for the workspace. Every path is in the operations reference.