A job ID means the service accepted a request you can inspect. It does not mean a playable video exists. When the assistant reports success but you cannot find the output, retrieve that exact job before starting another one.
This diagnostic is for the gap between an accepted creation request and a usable returned file. It is narrower than designing a complete content agent: the task is to locate the existing work, identify its actual state and hand back either verified media or a precise failure.
The examples use Prolifik's documented MCP tools. They are hypothetical incident records, not transcripts of successful production jobs or promises about processing time.
Recover the job identity before reading the conversation summary
Find the identifier in the actual creation response. A chat summary saying “five videos created” may describe the user's request rather than the service result. Keep the raw job ID, brand and requested format together.
If the assistant lost the ID, list recent jobs and match the work carefully. Compare the selected brand, intended copy and creation context. Do not assume the newest job belongs to the current request if another person or automation can create work in the same account.
For a fictional example, the requested piece says “Label the owner before the handoff.” A recent job about invoice reminders is not the missing job, even if both use Text Story and request one video.
Ask the matching read tool a specific question
Use get_content_job for a Content Studio job. For clipping, use get_clip_job_status to follow progress and get_clip_job to retrieve the clips. Do not query a content-piece identifier as though it were a clip job.
Current Content Studio job descriptions include settled states such as ready_for_review, completed and partially_failed. The relevant evidence still includes the returned pieces. A high-level settled status does not guarantee that every requested message has a usable file.
The batch-generation guide explains how to construct the request. During diagnosis, preserve that request and inspect its results rather than rebuilding it from a shorter prompt.
Build a one-line record for each missing output
| Observed case | Evidence to retain | Next diagnostic action |
|---|---|---|
| Job still processing | Exact job ID and current response | Read it again within a bounded wait policy |
| Some pieces failed | Piece ID, script and reported reason | Hold those pieces and preserve successful ones |
| Ready media returned | Piece ID and current media link | Open the file and check it plays |
| Old link stopped working | Existing piece/job ID | Retrieve fresh access instead of regenerating |
| File does not match the brief | Actual script and source identity | Resolve the mismatch before accepting it |
Record the specific failure rather than collapsing every case into not ready. A render error, a stale link and an inaccurate script have different remedies.
Bound the waiting and preserve the handle
Choose a reasonable observation window for your own client and workflow. Keep polling read-only operations while the service reports work in progress, but stop the loop at your chosen deadline and report the latest state honestly.
A timeout in the observer is not proof that the remote job stopped. Store the identifier so the next session can resume inspection. Do not cancel or recreate the job merely because the chat could not remain active long enough to see completion.
Conceptual recovery logic can be simple:
retrieve the stored job
if it is still processing:
read it again until the observation deadline
if the observation deadline arrives:
preserve the same job ID and last known state
if pieces exist:
inspect each piece and its media independently
This sketch does not define new Prolifik status values. Use the actual tool response and documented schema in a real implementation.
Do not regenerate an expired download
Signed media links can expire. The stable identifier is what lets you request the existing result again. Keep it in your production record instead of treating a temporary URL as the only reference to the video.
If a refreshed response supplies a link but the file is still unavailable, retain the exact error and stop at that boundary. Do not report a successful render as usable until you can actually access the expected media.
Once you open the file, check its duration, visible content and audio. A valid download of the wrong piece does not satisfy the request. This check is particularly important when several nearly identical variants share one job.
Separate a repair decision from the diagnostic report
The useful read-only report names what exists and what is missing. A failed piece may later need a retry of the same script. A creative correction may need an edit and replacement render. Those actions are not automatically authorized by asking where the video went.
Prolifik distinguishes retrying an existing failed render from regeneration that replaces the piece's script and assets. Keep that difference visible when asking the owner what to repair. Preserve accepted sibling pieces rather than rerunning the entire batch to make its status look cleaner.
The content-agent state guide explains the broader handoff to review and publishing. For the immediate incident, finish with the exact job, the usable files you opened, the failed pieces and the next authorized action.
Use the Prolifik MCP tool reference to select the matching retrieval operation. The strongest completion statement is an accessible, inspected output, not an assistant repeating that the create call succeeded.
Retrieve the exact job before creating more work
Use the matching read tool and retain piece identifiers, current media and precise failures in the diagnostic handoff.
Read the MCP retrieval toolsFacts checked 2026-10-24. Worked examples are illustrative unless a real source is identified.
- Prolifik MCP job retrieval and lifecycle Checked 2026-10-24
- Prolifik REST API background jobs and media access Checked 2026-10-24
