Document apiReferenceFields

fields.rebuild

Rebuild (recalculate) a field.

mutates documentdry runidempotent
doc.fields.rebuild(…)

Expected result

Returns a FieldMutationResult indicating success or a failure.

Inputs

targetobjectrequired
Fields
kind"field"required
blockIdstringrequired
occurrenceIndexintegerrequired
nestingDepthinteger
storyIdstring
fieldIdstring

Result

Output fields
true
successtruerequired
fieldobjectrequired
Fields
kind"field"required
blockIdstringrequired
occurrenceIndexintegerrequired
nestingDepthinteger
storyIdstring
fieldIdstring
false
successfalserequired
failureobjectrequired
Fields
codestringrequired
messagestringrequired
detailsunknown

Failures

Pre-apply throws

  • TARGET_NOT_FOUND
  • INVALID_TARGET
  • INVALID_INPUT
1 more codes
  • CAPABILITY_UNAVAILABLE

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