# 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 Myself API
  version: 1.0.0
extends: openapi/jira-myself-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: 6
- target: $.paths['/rest/api/3/mypreferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my user preferences
      effect: read
      questions:
      - What value is set for one of my Jira user preferences?
      - Can I read a custom preference key I stored for my user?
      instructions:
      - text: Get my preference {key}.
        slots:
          key: query.key
      - text: Show the current value of user preference {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/mypreferences'].put
  update:
    x-apievangelist-phrasing:
      intent: Set one of my user preferences
      effect: write
      questions:
      - How do I change a user preference like email notification format?
      - Can I store an arbitrary preference value up to 255 characters?
      instructions:
      - text: Set my preference {key}.
        slots:
          key: query.key
      - text: Create or update user preference {key} with the given value.
        slots:
          key: query.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/mypreferences'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one of my user preferences
      effect: destructive
      questions:
      - How do I restore a system preference to its default value?
      - Can I delete a custom preference I set earlier?
      instructions:
      - text: Delete my preference {key}.
        slots:
          key: query.key
      - text: Reset user preference {key} to its default.
        slots:
          key: query.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/mypreferences/locale'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my locale
      effect: read
      questions:
      - What locale is my account using?
      - If I have no language preference, which locale is returned?
      instructions:
      - text: Show my current locale.
      - text: Get the language locale for my user.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/mypreferences/locale'].put
  update:
    x-apievangelist-phrasing:
      intent: Set my locale (deprecated)
      effect: write
      questions:
      - Can I still change my language locale through the deprecated my-preferences endpoint?
      - Which locales can I switch my account to?
      instructions:
      - text: Set my locale to {locale}.
        slots:
          locale: requestBody.locale
      - text: Change my language to {locale} using the deprecated locale call.
        slots:
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/myself'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current user
      effect: read
      questions:
      - Who am I logged in as, and what is my account ID?
      - Can I see my own groups and application roles?
      instructions:
      - text: Show details of the current user.
      - text: Get my user profile with {expand} expanded.
        slots:
          expand: query.expand
      method: generated
      generated: '2026-09-26'