# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OPERA Cloud CRM Configuration Profile Configuration API
  version: 1.0.0
extends: openapi/oracle-hospitality-profileconfiguration-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: 50
- target: $.paths['/addressFormats'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up configured address formats
      effect: read
      questions:
      - Which address formats are set up for guest profiles in OPERA Cloud?
      - Can I find address formats by a partial code match?
      instructions:
      - text: Show me the address formats with codes {codes}.
        slots:
          codes: query.codes
      - text: List every address format configured for profiles.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/addressFormats'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing address formats
      effect: write
      questions:
      - How do I change the layout of an address format that already exists?
      - Is it possible to edit several existing address formats in one request?
      instructions:
      - text: 'Update the existing address formats with these changes: {formats}.'
        slots:
          formats: requestBody.formats
      - text: Change the field order on our current address format definitions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/addressFormats'].post
  update:
    x-apievangelist-phrasing:
      intent: Create new address formats
      effect: write
      questions:
      - How can I add a new address format for a country we just started serving?
      - What do I send to define a brand-new address format for profiles?
      instructions:
      - text: Create new address formats {formats}.
        slots:
          formats: requestBody.formats
      - text: Add a new address format definition to profile configuration.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/addressFormats'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete address formats
      effect: destructive
      questions:
      - How do I remove address formats we no longer use?
      - Can I delete more than one address format by its code at once?
      instructions:
      - text: Delete the address formats with codes {formatCodes}.
        slots:
          formatCodes: query.formatCodes
      - text: Remove address format {formatCodes} from configuration.
        slots:
          formatCodes: query.formatCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/claimAdjustmentLimits'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up claim adjustment limits (deprecated)
      effect: read
      questions:
      - What claim adjustment limits are configured for a property?
      - Can I still read claim adjustment limits even though the endpoint is deprecated?
      instructions:
      - text: Show claim adjustment limits for hotel {hotelId}.
        slots:
          hotelId: query.hotelId
      - text: Get the claim adjustment limits with codes {limitCodes}.
        slots:
          limitCodes: query.limitCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/claimAdjustmentLimits'].put
  update:
    x-apievangelist-phrasing:
      intent: Change existing claim adjustment limits
      effect: write
      questions:
      - How do I modify claim adjustment limits that are already configured?
      - Is the change endpoint for claim adjustment limits deprecated?
      instructions:
      - text: Change the existing claim adjustment limits to {claimAdjustmentLimits}.
        slots:
          claimAdjustmentLimits: requestBody.claimAdjustmentLimits
      - text: Edit our current claim adjustment limit amounts using the deprecated change endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/claimAdjustmentLimits'].post
  update:
    x-apievangelist-phrasing:
      intent: Create new claim adjustment limits
      effect: write
      questions:
      - How can I set up a new claim adjustment limit?
      - What does it take to add claim adjustment limits that don't exist yet?
      instructions:
      - text: Create claim adjustment limits {claimAdjustmentLimits}.
        slots:
          claimAdjustmentLimits: requestBody.claimAdjustmentLimits
      - text: Add a brand-new claim adjustment limit through the deprecated create endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/upsert/claimAdjustmentLimits'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update claim adjustment limits
      effect: write
      questions:
      - Can I create a claim adjustment limit or update it if it already exists in one call?
      - Is there an upsert for claim adjustment limits?
      instructions:
      - text: Upsert claim adjustment limits {claimAdjustmentLimits}, creating any that are missing.
        slots:
          claimAdjustmentLimits: requestBody.claimAdjustmentLimits
      - text: Create or overwrite our claim adjustment limits in a single upsert.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/creditRatings'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up credit rating codes
      effect: read
      questions:
      - What credit rating codes can be assigned to profiles?
      - Can I include inactive credit ratings when I list them?
      - How do I search credit ratings by their description?
      instructions:
      - text: List credit ratings including inactive ones.
      - text: Find credit ratings whose description matches {description}.
        slots:
          description: query.description
      - text: Show credit ratings with codes {codes}.
        slots:
          codes: query.codes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/creditRatings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing credit ratings
      effect: write
      questions:
      - How do I edit the description of a credit rating that already exists?
      - Can I deactivate an existing credit rating code?
      instructions:
      - text: Update the existing credit ratings with {creditRatings}.
        slots:
          creditRatings: requestBody.creditRatings
      - text: Change the settings on our current credit rating codes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/creditRatings'].post
  update:
    x-apievangelist-phrasing:
      intent: Create new credit ratings
      effect: write
      questions:
      - How can I add a new credit rating code for profiles?
      - What do I need to define a new credit rating?
      instructions:
      - text: Create credit ratings {creditRatings}.
        slots:
          creditRatings: requestBody.creditRatings
      - text: Add a new credit rating code to profile configuration.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/creditRatings'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete credit ratings
      effect: destructive
      questions:
      - How do I remove a credit rating code we no longer use?
      - Can several credit ratings be deleted in one call?
      instructions:
      - text: Delete credit ratings {creditRatings}.
        slots:
          creditRatings: query.creditRatings
      - text: Remove the credit rating code {creditRatings} from configuration.
        slots:
          creditRatings: query.creditRatings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exclusivePreferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up template exclusive preferences
      effect: read
      questions:
      - Which exclusive preferences are defined at the template level?
      - Can I filter template exclusive preferences by preference group?
      instructions:
      - text: Show template exclusive preferences in preference groups {preferenceGroupsCodes}.
        slots:
          preferenceGroupsCodes: query.preferenceGroupsCodes
      - text: Get template exclusive preferences with codes {exclusivePreferenceCodes}.
        slots:
          exclusivePreferenceCodes: query.exclusivePreferenceCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exclusivePreferences'].put
  update:
    x-apievangelist-phrasing:
      intent: Update template exclusive preferences
      effect: write
      questions:
      - How do I change an exclusive preference in the template, not at a hotel?
      - Can I edit which preferences are mutually exclusive in the template?
      instructions:
      - text: Update the template exclusive preferences with {templateExclusivePreferences}.
        slots:
          templateExclusivePreferences: requestBody.templateExclusivePreferences
      - text: Change an existing template-level exclusive preference rule.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exclusivePreferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template exclusive preferences
      effect: write
      questions:
      - How can I add a new exclusive preference to the template for all properties?
      - What do I send to create a template exclusive preference?
      instructions:
      - text: Create template exclusive preferences {templateExclusivePreferences}.
        slots:
          templateExclusivePreferences: requestBody.templateExclusivePreferences
      - text: Add a new exclusive preference at the template level.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exclusivePreferences'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template exclusive preference
      effect: destructive
      questions:
      - How do I remove an exclusive preference from the template?
      - What identifies a template exclusive preference when deleting it?
      instructions:
      - text: Delete template exclusive preference {exclusivePreferenceCode} in group {exclusivePreferenceGroup}.
        slots:
          exclusivePreferenceCode: query.exclusivePreferenceCode
          exclusivePreferenceGroup: query.exclusivePreferenceGroup
      - text: Remove the template-level exclusive preference {exclusivePreferenceCode} from group {exclusivePreferenceGroup}.
        slots:
          exclusivePreferenceCode: query.exclusivePreferenceCode
          exclusivePreferenceGroup: query.exclusivePreferenceGroup
      method: generated
      generated: '2026-09-26'
- target: $.paths['/exclusivePreferences/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy exclusive preferences
      effect: write
      questions:
      - Can I copy exclusive preferences from the template to other hotels?
      - How do I duplicate exclusive preference setup instead of recreating it?
      instructions:
      - text: 'Copy exclusive preferences using these copy instructions: {copyInstructions}.'
        slots:
          copyInstructions: requestBody.copyInstructions
      - text: Duplicate our exclusive preference setup to another property.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/exclusivePreferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hotel's exclusive preferences
      effect: read
      questions:
      - Which exclusive preferences are configured at a specific hotel?
      - Can I see a property's exclusive preferences for certain preference codes only?
      instructions:
      - text: Show the exclusive preferences configured at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Get hotel {hotelId} exclusive preferences for preference codes {preferenceCodes}.
        slots:
          hotelId: path.hotelId
          preferenceCodes: query.preferenceCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/exclusivePreferences'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's exclusive preferences
      effect: write
      questions:
      - How do I change an exclusive preference rule at one property?
      - Can I edit hotel-level exclusive preferences without touching the template?
      instructions:
      - text: Update exclusive preferences at hotel {hotelId} with {hotelExclusivePreferences}.
        slots:
          hotelId: path.hotelId
          hotelExclusivePreferences: requestBody.hotelExclusivePreferences
      - text: Change an existing exclusive preference at property {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/exclusivePreferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create exclusive preferences at a hotel
      effect: write
      questions:
      - How can I add a new exclusive preference for a single property?
      - What do I send to create hotel-level exclusive preferences?
      instructions:
      - text: Create exclusive preferences {hotelExclusivePreferences} at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
          hotelExclusivePreferences: requestBody.hotelExclusivePreferences
      - text: Add a new exclusive preference rule to property {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/exclusivePreferences'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an exclusive preference at a hotel
      effect: destructive
      questions:
      - How do I remove an exclusive preference from one hotel only?
      - What do I need to delete a hotel-level exclusive preference?
      instructions:
      - text: Delete exclusive preference {exclusivePreferenceCode} in group {exclusivePreferenceGroup} at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
          exclusivePreferenceCode: query.exclusivePreferenceCode
          exclusivePreferenceGroup: query.exclusivePreferenceGroup
      - text: Remove hotel {hotelId}'s exclusive preference {exclusivePreferenceCode} from group {exclusivePreferenceGroup}.
        slots:
          hotelId: path.hotelId
          exclusivePreferenceCode: query.exclusivePreferenceCode
          exclusivePreferenceGroup: query.exclusivePreferenceGroup
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hotel's configured guest preferences
      effect: read
      questions:
      - What guest preferences are configured at a particular hotel?
      - Can I see which user created a hotel's preferences?
      instructions:
      - text: List all guest preferences configured at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
      - text: Show hotel {hotelId} preferences in groups {preferenceGroupsCodes}.
        slots:
          hotelId: path.hotelId
          preferenceGroupsCodes: query.preferenceGroupsCodes
      - text: Find preferences at hotel {hotelId} created by users {createdByUserIds}.
        slots:
          hotelId: path.hotelId
          createdByUserIds: query.createdByUserIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preferences'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a hotel's guest preferences
      effect: write
      questions:
      - How do I change an existing guest preference at one property?
      - Can I rename a preference that's already configured at a hotel?
      instructions:
      - text: Update the preferences at hotel {hotelId} with {hotelPreferences}.
        slots:
          hotelId: path.hotelId
          hotelPreferences: requestBody.hotelPreferences
      - text: Change the existing guest preferences configured at property {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create guest preferences at a hotel
      effect: write
      questions:
      - How can I add a new guest preference, like a pillow type, for one hotel?
      - What do I send to create preferences at the hotel level?
      instructions:
      - text: Create preferences {hotelPreferences} at hotel {hotelId}.
        slots:
          hotelId: path.hotelId
          hotelPreferences: requestBody.hotelPreferences
      - text: Add a new guest preference option to property {hotelId}.
        slots:
          hotelId: path.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hotels/{hotelId}/preferences'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a guest preference at a hotel
      effect: destructive
      questions:
      - How do I remove a guest preference from a specific hotel's configuration?
      - Which values identify a hotel preference I want to delete?
      instructions:
      - text: Delete guest preference {preferenceCode} from group {preferenceGroup} for property {hotelId}.
        slots:
          hotelId: path.hotelId
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
      - text: Remove hotel {hotelId}'s preference {preferenceCode} from group {preferenceGroup} using the hotel endpoint.
        slots:
          hotelId: path.hotelId
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preference'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a global or hotel preference
      effect: destructive
      questions:
      - Can one call delete a preference at either the global level or a hotel level?
      - How do I remove a global preference that isn't tied to a property?
      instructions:
      - text: Delete the global preference {preferenceCode} in group {preferenceGroup}.
        slots:
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
      - text: Using the combined global-and-hotel delete, remove preference {preferenceCode} in group {preferenceGroup} for hotel {hotelId}.
        slots:
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
          hotelId: query.hotelId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferenceGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up preference groups
      effect: read
      questions:
      - What preference groups exist for organizing guest preferences?
      - Can I search preference groups with a wildcard?
      instructions:
      - text: Show preference groups with codes {preferenceGroupsCodes}.
        slots:
          preferenceGroupsCodes: query.preferenceGroupsCodes
      - text: List all preference groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferenceGroups'].put
  update:
    x-apievangelist-phrasing:
      intent: Update preference groups
      effect: write
      questions:
      - How do I modify several preference groups at the same time?
      - Can I change the description of an existing preference group?
      instructions:
      - text: Update preference groups with {preferenceGroups}.
        slots:
          preferenceGroups: requestBody.preferenceGroups
      - text: Change the settings of our existing preference groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferenceGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a preference group
      effect: write
      questions:
      - How can I add a new preference group, such as room features?
      - What do I send to create a preference group?
      instructions:
      - text: Create preference groups {preferenceGroups}.
        slots:
          preferenceGroups: requestBody.preferenceGroups
      - text: Add a new preference group for guest preferences.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferenceGroups'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a preference group
      effect: destructive
      questions:
      - How do I remove a preference group we no longer need?
      - What code do I pass to delete a preference group?
      instructions:
      - text: Delete preference group {preferenceGroup}.
        slots:
          preferenceGroup: query.preferenceGroup
      - text: Remove the {preferenceGroup} preference group entirely.
        slots:
          preferenceGroup: query.preferenceGroup
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferences'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up template preferences
      effect: read
      questions:
      - Which preferences are defined in the template rather than at a hotel?
      - Can I filter template preferences by group code?
      instructions:
      - text: Show template preferences in groups {preferenceGroupsCodes}.
        slots:
          preferenceGroupsCodes: query.preferenceGroupsCodes
      - text: Get template preferences with codes {preferenceCodes}.
        slots:
          preferenceCodes: query.preferenceCodes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferences'].put
  update:
    x-apievangelist-phrasing:
      intent: Update template preferences
      effect: write
      questions:
      - How do I change a preference in the template used across properties?
      - Can I edit existing template preferences in bulk?
      instructions:
      - text: Update template preferences with {templatePreferences}.
        slots:
          templatePreferences: requestBody.templatePreferences
      - text: Change the existing template-level guest preferences.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create template preferences
      effect: write
      questions:
      - How can I add a new preference to the template for every property?
      - What do I send to create template preferences?
      instructions:
      - text: Create template preferences {templatePreferences}.
        slots:
          templatePreferences: requestBody.templatePreferences
      - text: Add a new guest preference at the template level.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferences'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template preference
      effect: destructive
      questions:
      - How do I remove a preference from the template?
      - What do I pass to delete a template-level preference?
      instructions:
      - text: Delete template preference {preferenceCode} in group {preferenceGroup}.
        slots:
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
      - text: Remove {preferenceCode} from the template preferences in group {preferenceGroup}.
        slots:
          preferenceCode: query.preferenceCode
          preferenceGroup: query.preferenceGroup
      method: generated
      generated: '2026-09-26'
- target: $.paths['/preferences/copy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy guest preferences
      effect: write
      questions:
      - Can I copy guest preferences from the template to other hotels?
      - How do I duplicate a set of preferences instead of creating each one again?
      instructions:
      - text: 'Copy preferences using these copy instructions: {copyInstructions}.'
        slots:
          copyInstructions: requestBody.copyInstructions
      - text: Duplicate our guest preference setup to another property.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profileNameValidations'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up profile name validations
      effect: read
      questions:
      - What profile name validation rules are configured?
      - Can I look up name validations for a specific profile type?
      instructions:
      - text: Show profile name validations for profile types {typeCodes}.
        slots:
          typeCodes: query.typeCodes
      - text: Find the name validation rule for the name {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profileNameValidations'].put
  update:
    x-apievangelist-phrasing:
      intent: Update profile name validations
      effect: write
      questions:
      - How do I change an existing profile name validation rule?
      - Can I edit several name validations at once?
      instructions:
      - text: Update profile name validations with {profileNames}.
        slots:
          profileNames: requestBody.profileNames
      - text: Change our existing profile name validation entries.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profileNameValidations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create profile name validations
      effect: write
      questions:
      - How can I add a new name validation rule for profiles?
      - What do I send to create profile name validations?
      instructions:
      - text: Create profile name validations {profileNames}.
        slots:
          profileNames: requestBody.profileNames
      - text: Add a new profile name validation entry.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profileNameValidations'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a profile name validation
      effect: destructive
      questions:
      - How do I remove a name validation for a given profile type?
      - What identifies a profile name validation when deleting it?
      instructions:
      - text: Delete the name validation for {profileName} on profile type {profileType}.
        slots:
          profileName: query.profileName
          profileType: query.profileType
      - text: Remove profile name validation {profileName} from {profileType} profiles.
        slots:
          profileName: query.profileName
          profileType: query.profileType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/upsert/profileNameValidations'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update profile name validations
      effect: write
      questions:
      - Is there an upsert for profile name validations?
      - Can I create a name validation or overwrite it if it exists in one call?
      instructions:
      - text: Upsert profile name validations {profileNames}.
        slots:
          profileNames: requestBody.profileNames
      - text: Create or update our profile name validations in a single upsert.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/links'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up profile links (deprecated)
      effect: read
      questions:
      - How do I read profile link types with the older deprecated links endpoint?
      - Can the legacy profile links call filter by from and to profile type?
      instructions:
      - text: Using the deprecated profile links endpoint, show links from {fromType} profiles to {toType} profiles.
        slots:
          fromType: query.fromType
          toType: query.toType
      - text: List legacy profile links configuration.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/links'].put
  update:
    x-apievangelist-phrasing:
      intent: Update profile links (deprecated)
      effect: write
      questions:
      - How do I change profile links through the deprecated links endpoint?
      - Is the profile links update call still supported?
      instructions:
      - text: Update legacy profile links with {profileLinks}.
        slots:
          profileLinks: requestBody.profileLinks
      - text: Change existing profile link definitions via the deprecated links endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/links'].post
  update:
    x-apievangelist-phrasing:
      intent: Create profile links (deprecated)
      effect: write
      questions:
      - How do I create profile links with the old deprecated links API?
      - What replaced the profile links create endpoint?
      instructions:
      - text: Create legacy profile links {profileLinks}.
        slots:
          profileLinks: requestBody.profileLinks
      - text: Add a new profile link type through the deprecated links endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/profiles/links'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a profile link (deprecated)
      effect: destructive
      questions:
      - How do I delete a profile link using the deprecated links endpoint?
      - Which four codes are required to remove a legacy profile link?
      instructions:
      - text: Using the deprecated links endpoint, delete the link from {fromType} {fromCode} to {toType} {toCode}.
        slots:
          fromType: query.fromType
          fromCode: query.fromCode
          toType: query.toType
          toCode: query.toCode
      - text: Remove legacy profile link {fromCode} to {toCode} between {fromType} and {toType} types.
        slots:
          fromType: query.fromType
          fromCode: query.fromCode
          toType: query.toType
          toCode: query.toCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relationships'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up profile relationship types
      effect: read
      questions:
      - Which relationship types can connect two profiles, like company to guest?
      - Can I list profile relationships for a given pair of profile types?
      instructions:
      - text: Show profile relationships from {fromType} profiles to {toType} profiles.
        slots:
          fromType: query.fromType
          toType: query.toType
      - text: List all configured profile relationship types.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relationships'].put
  update:
    x-apievangelist-phrasing:
      intent: Update profile relationship types
      effect: write
      questions:
      - How do I change an existing profile relationship definition?
      - Can I edit several profile relationships in one request?
      instructions:
      - text: Update profile relationships with {profileLinks}.
        slots:
          profileLinks: requestBody.profileLinks
      - text: Change our existing profile relationship definitions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relationships'].post
  update:
    x-apievangelist-phrasing:
      intent: Create profile relationship types
      effect: write
      questions:
      - How can I define a new relationship type between profiles?
      - What do I send to create profile relationships?
      instructions:
      - text: Create profile relationships {profileLinks}.
        slots:
          profileLinks: requestBody.profileLinks
      - text: Add a new relationship type linking two kinds of profiles.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relationships'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a profile relationship type
      effect: destructive
      questions:
      - How do I remove a relationship type between two profile types?
      - What codes do I need to delete a profile relationship?
      instructions:
      - text: Delete the profile relationship from {fromType} {fromCode} to {toType} {toCode}.
        slots:
          fromType: query.fromType
          fromCode: query.fromCode
          toType: query.toType
          toCode: query.toCode
      - text: Remove relationship {fromCode} to {toCode} between {fromType} and {toType} profiles.
        slots:
          fromType: query.fromType
          fromCode: query.fromCode
          toType: query.toType
          toCode: query.toCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/profile/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check profile configuration service health
      effect: read
      questions:
      - Is the profile configuration service up right now?
      - How can I ping the profile configuration service?
      instructions:
      - text: Ping the profile configuration service.
      - text: Check the profile configuration service status while signed in to hotel {hotel}.
        slots:
          hotel: header.x-hotelid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/upsert/relationships'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update profile relationships
      effect: write
      questions:
      - Is there an upsert for profile relationship types?
      - Can I create a profile relationship or update it if it exists in one call?
      instructions:
      - text: Upsert profile relationships {profileLinks}.
        slots:
          profileLinks: requestBody.profileLinks
      - text: Create or overwrite our profile relationships in a single upsert.
      method: generated
      generated: '2026-09-26'