attach_post_cover_from_job
Attach a previously generated ai-media job's output as the post's featuredImage. Use when generate_post_cover timed out (job kept running) or when reusing the same generation across multiple posts. Verifies the job belongs to your company and succeeded. Does NOT charge credits — credits were charged at submit time.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | Yes | The ai-media job ID (from generate_image, generate_post_cover, or POST /v6/merchant/ai-media/generate) | |
| postId | Yes | The post ID | |
| assetIndex | No | Which asset to use when the job produced multiple outputs. Default 0. | |
| pollIfRunning | No | When true, advance polling once if the job is still running. Default true. | |
| pollTimeoutMs | No | When pollIfRunning is true, wait up to this long for terminal state. Default 30000. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Tool result payload — shape varies per tool, see the tool description | |
| summary | Yes | One-line human-readable summary of the action | |
| renderType | Yes | UI rendering hint for the result |