Reference
API jobs
Durable document, research and brand image jobs.
Submit
Choose API > Playground, website, environment and operation. Documents accept structured JSON (format, title, and sections, sheets or slides). Research accepts a question up to 600 characters. Brand media accepts an image prompt. Requests are limited to 12,000 characters. Confirm before submitting: both environments run the real service and consume the workspace owner's allowance.
Lifecycle
Jobs move from queued to running and then succeeded, failed or cancelled. IDs are durable and idempotent for the same payload. The workspace supports at most 10 queued/running jobs. Failed jobs can be retried up to three attempts. Interrupted running jobs become failed for review instead of automatically repeating a potentially billable provider call. Queued jobs resume after restarts.
Results and cancellation
Inspect request and result details in API > Jobs. Generated files use authenticated download links. Cancellation stops queued work; already submitted provider work may finish and stays counted. Research uses the existing Buckhy researcher, documents use the document renderer, and brand images use the configured gpt-image-2 service. Provider errors remain failed jobs, never simulated success.
