mcp

Generate Asset

Start an async Writer visual-asset generation through DesignForYou.

Normalizes a structured asset-generation/v1 brief, then kicks off a background job that asks DesignForYou to recommend a template and calls its /api/mcp/generate tool. Returns immediately with {job_id, status: "running"} — poll get_asset_status until the job is terminal. The expert image-edit path can take well over two minutes, so this never blocks the HTTP request. Pass generation.session_id to refine a previous result, and generation.context_ids to use prior DesignForYou designs as visual references.

post/api/mcp/generate_asset

Request

  • Base URL: https://writer.swapp1990.org (the document declares no server; this is the origin it was published from)
  • URL: https://writer.swapp1990.org/api/mcp/generate_asset
  • Auth: none declared

Request body

request_idstring nullable

Optional idempotency/correlation id. Writer creates one if omitted.

asset_kindstring

cover, poster, icon, social_post, screenshot, character, background, diagram, or other.

use_casestring required

Short natural-language summary of why the asset is needed.

audiencestring nullable

Optional target audience.

platformstring nullable

Optional publishing target.

Response

Successful Response

story_urlstring nullable
article_urlstring nullable
job_idstring nullable
statusstring nullable
is_terminalboolean nullable

Changes

No recorded changes to this operation across all 1 revision of this API.