# 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 associations API
  version: 1.0.0
extends: openapi/jira-issue-custom-field-associations-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/field/association'].put
  update:
    x-apievangelist-phrasing:
      intent: Associate fields with projects and issue types
      effect: write
      questions:
      - How do I make a set of fields available in certain projects?
      - Will associating a field also affect other projects sharing the same field configuration?
      instructions:
      - text: Associate fields {fields} with contexts {associationContexts}.
        slots:
          fields: requestBody.fields
          associationContexts: requestBody.associationContexts
      - text: Add fields {fields} to the projects and issue types in {associationContexts}.
        slots:
          fields: requestBody.fields
          associationContexts: requestBody.associationContexts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/field/association'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassociate fields from projects and issue types
      effect: destructive
      questions:
      - How do I remove fields from a project and issue type combination?
      - Does unassociating a field hit every project sharing that field configuration?
      instructions:
      - text: Unassociate fields {fields} from contexts {associationContexts}.
        slots:
          fields: requestBody.fields
          associationContexts: requestBody.associationContexts
      - text: Remove fields {fields} from the projects and issue types in {associationContexts}.
        slots:
          fields: requestBody.fields
          associationContexts: requestBody.associationContexts
      method: generated
      generated: '2026-09-26'