Document apiReferenceImages

images.replaceSource

Replace the image source while preserving identity and placement.

mutates documenttracked modedry runnon-idempotent
doc.images.replaceSource(…)

Expected result

Returns an ImagesMutationResult with the updated image address.

Inputs

imageIdstringrequired
srcstringrequired
1 additional input field
resetSizeboolean

Result

Output fields
successboolean
imageobject
failureobject

Failures

Pre-apply throws

  • TARGET_NOT_FOUND
  • AMBIGUOUS_TARGET
  • INVALID_TARGET
2 more codes
  • CAPABILITY_UNAVAILABLE
  • INVALID_INPUT

Non-applied receipt codes

  • NO_OP

Raw schemas

Open the generated JSON artifact for the exact input, output, success, and failure schemas represented by this contract version.

View raw JSON schemas