# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Cloud platform REST Issue custom field values (apps)…
  version: 1.0.0
extends: openapi/jira-issue-custom-field-values-apps-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/rest/api/3/app/field/value'].post
  update:
    x-apievangelist-phrasing:
      intent: Update several app custom fields on issues
      effect: write
      questions:
      - Can my app update values of multiple custom fields across many issues at once?
      - Is it possible to skip writing a changelog when an app updates custom field values?
      instructions:
      - text: Apply custom field value updates {updates} across the issues listed.
        slots:
          updates: requestBody.updates
      - text: Update several app fields with {updates} and generate a changelog ({generateChangelog}).
        slots:
          updates: requestBody.updates
          generateChangelog: query.generateChangelog
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/app/field/{fieldIdOrKey}/value'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one app custom field on issues
      effect: write
      questions:
      - How does an app set the value of its own custom field on several issues?
      - Can an app change a single custom field's value without firing app events?
      instructions:
      - text: Set custom field {fieldIdOrKey} using updates {updates}.
        slots:
          fieldIdOrKey: path.fieldIdOrKey
          updates: requestBody.updates
      - text: Update field {fieldIdOrKey} on the listed issues with {updates}, app events {generateAppEvents}.
        slots:
          fieldIdOrKey: path.fieldIdOrKey
          updates: requestBody.updates
          generateAppEvents: query.generateAppEvents
      method: generated
      generated: '2026-09-26'