Document apiReferenceImages

images.updateCaption

Update the text of an existing caption paragraph.

mutates documenttracked modedry runconditional
doc.images.updateCaption(…)

Expected result

Returns an ImagesMutationResult; reports NO_OP if text unchanged.

Inputs

imageIdstringrequired
textstringrequired

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