Workflows API: Search, Video Ideas and Script from an Idea

Search a FoxCue workspace, turn one public article into video ideas, and create a script from an idea. Script generation stays under the $0.05 cap.

Workflows are short, durable sequences over records you already have. They are in the live OpenAPI schema. Long work returns an id you poll. It does not call you back.

GET /workflows/search searches one family of workspace records (brands, silos, sources or scripts) by title. The call also needs that family's read scope.

Article to ideas

POST /workflows/video-ideas resolves or imports one public article and queues the bounded idea plan for a brand and silo. GET /workflows/video-ideas/{id} reads that workflow and its decision run. Idea planning can send work to a configured model provider.

The same job in the app is Ideas.

Script from an idea

POST /workflows/script-from-idea creates one durable script from a brand and an idea, with the public evidence pinned. GET /workflows/idea-workflows/{id} reads it after the server rechecks your access. POST /workflows/idea-workflows/{id}/cancel stops generation and keeps the saved draft.

Script generation accepts cost_limit_usd up to $0.05. That ceiling is the maximum in the script.generate schema. You can set a lower ceiling. You cannot raise it. See Script costs.

On this page