mcp

Update Character Asset

Patch generated image metadata for one cast member.

Use this for concept art and character sheets. It avoids resending the whole cast through update_characters when only one generated asset changed.

post/api/mcp/update_character_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/update_character_asset
  • Auth: none declared

Request body

job_idstring required

The story job ID.

character_indexinteger required

0-based index of the cast member to patch.

character_namestring nullable

Optional name guard; when provided, the indexed character must still match.

asset_type'concept_art' | 'character_sheet' | 'full_body_images' required

Which visual asset field to patch on the cast member. full_body_images accepts {images:[{url:...}]}.

assetobject nullable

Generated or client-owned asset metadata. Pass null to remove this asset field.

appendboolean

For full_body_images, append the supplied images instead of replacing the collection.

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.