API Evangelist conversational phrasing for Infobip OpenAPI Specification Customer Engagement API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Infobip OpenAPI Specification Customer Engagement API
  version: 1.0.0
extends: openapi/infobip-customer-engagement-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: 254
- target: $.paths['/people/2/persons'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one person or list people profiles
      effect: read
      questions:
      - How do I look up a customer profile in Infobip People by their email or phone?
      - Can I list all people profiles filtered by my own conditions, a page at a time?
      - What's the maximum number of people profiles returned per page when listing?
      instructions:
      - text: Find the person profile whose {type} identifier is {identifier}.
        slots:
          type: query.type
          identifier: query.identifier
      - text: List people profiles matching the filter {filter}, {limit} per page.
        slots:
          filter: query.filter
          limit: query.limit
      - text: Show me how many people profiles exist in total.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons'].put
  update:
    x-apievangelist-phrasing:
      intent: Overwrite a person profile
      effect: write
      questions:
      - Can I completely overwrite a person's profile with new data in one request?
      - What happens to fields I leave out when I replace a whole person profile?
      instructions:
      - text: Overwrite the full profile of the person with {type} identifier {identifier}, setting first name {firstName} and last name {lastName}.
        slots:
          type: query.type
          identifier: query.identifier
          firstName: requestBody.firstName
          lastName: requestBody.lastName
      - text: Replace the entire profile of person {identifier} so their city is {city} and country {country}.
        slots:
          identifier: query.identifier
          city: requestBody.city
          country: requestBody.country
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a person profile
      effect: write
      questions:
      - How can I add a single new customer profile to People?
      - Can I set custom attributes and tags when creating one new person?
      instructions:
      - text: Create a new person named {firstName} {lastName}.
        slots:
          firstName: requestBody.firstName
          lastName: requestBody.lastName
      - text: Add a new person profile with external ID {externalId} and tags {tags}.
        slots:
          externalId: requestBody.externalId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a person profile
      effect: destructive
      questions:
      - Can I permanently remove a single customer's profile from People?
      - What identifier do I need to delete one person profile?
      instructions:
      - text: Delete the person whose {type} identifier is {identifier}.
        slots:
          type: query.type
          identifier: query.identifier
      - text: Remove person profile {identifier} from People.
        slots:
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update selected fields on a person profile
      effect: write
      questions:
      - Can I change just a few fields on a person profile without resending everything?
      - Is there a partial update that keeps a person's other attributes untouched?
      instructions:
      - text: Patch person {identifier} so only their preferred language becomes {preferredLanguage}.
        slots:
          identifier: query.identifier
          preferredLanguage: requestBody.preferredLanguage
      - text: Update just the birth date of the person with {type} identifier {identifier} to {birthDate}.
        slots:
          type: query.type
          identifier: query.identifier
          birthDate: requestBody.birthDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/contactInformation'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all contact details on a person
      effect: write
      questions:
      - Can I replace every email and mobile number on a person with a fresh set?
      - What happens to existing phone numbers when I set a person's contact information?
      instructions:
      - text: Replace all emails and phones on person {identifier} with {contactInformation}.
        slots:
          identifier: query.identifier
          contactInformation: requestBody.contactInformation
      - text: Set the contact information of the person with {type} identifier {identifier} to exactly {contactInformation}.
        slots:
          type: query.type
          identifier: query.identifier
          contactInformation: requestBody.contactInformation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/contactInformation'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove specific emails or phones from a person
      effect: destructive
      questions:
      - Can I delete one outdated email address from a person without touching the rest?
      - How would I strip a specific mobile number off a customer's profile?
      instructions:
      - text: Remove the contact details {contactInformation} from person {identifier}.
        slots:
          contactInformation: requestBody.contactInformation
          identifier: query.identifier
      - text: Delete these emails and phones {contactInformation} from the person with {type} ID {identifier}.
        slots:
          contactInformation: requestBody.contactInformation
          type: query.type
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/contactInformation'].patch
  update:
    x-apievangelist-phrasing:
      intent: Add emails or phones to a person
      effect: write
      questions:
      - Can I add a second email address to an existing person while keeping the old one?
      - Is it possible to append a new mobile number to someone's profile?
      instructions:
      - text: Add the contact details {contactInformation} to person {identifier}, keeping existing ones.
        slots:
          contactInformation: requestBody.contactInformation
          identifier: query.identifier
      - text: Append a new email or phone {contactInformation} to the person with {type} identifier {identifier}.
        slots:
          contactInformation: requestBody.contactInformation
          type: query.type
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Create many person profiles at once
      effect: write
      questions:
      - Can I import up to a thousand new people profiles in a single call?
      - What's the size limit for bulk-creating people?
      instructions:
      - text: 'Bulk-create these person profiles: {people}.'
        slots:
          people: requestBody.people
      - text: 'Create all of the following people in one batch: {people}.'
        slots:
          people: requestBody.people
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/batch'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many person profiles at once
      effect: destructive
      questions:
      - Can I delete hundreds of people profiles in one request?
      - What is the cap on how many persons a bulk delete can remove?
      instructions:
      - text: 'Bulk-delete these person profiles: {people}.'
        slots:
          people: requestBody.people
      - text: 'Remove all of these people from People in one batch: {people}.'
        slots:
          people: requestBody.people
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/batch'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update many person profiles at once
      effect: write
      questions:
      - Can I update the attributes of many existing people in one request?
      - Is there a bulk edit for person profiles, and how many can it take?
      instructions:
      - text: 'Bulk-update these existing person profiles with the new data: {people}.'
        slots:
          people: requestBody.people
      - text: 'Apply these profile changes to many people at once: {people}.'
        slots:
          people: requestBody.people
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/persons/match'].post
  update:
    x-apievangelist-phrasing:
      intent: Match identities to existing person profiles
      effect: read
      questions:
      - Can I check which of my emails or phone numbers already belong to a person profile?
      - How can I get the internal person IDs for a list of external identities?
      instructions:
      - text: 'Match these identities against existing people and return their person IDs: {identities}.'
        slots:
          identities: requestBody.identities
      - text: Find which of {identities} already have a profile in People.
        slots:
          identities: requestBody.identities
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/persons/merge'].post
  update:
    x-apievangelist-phrasing:
      intent: Merge duplicate person profiles
      effect: write
      questions:
      - Can I merge duplicate profiles that belong to the same customer?
      - Which identifiers are used to decide that two profiles should be merged?
      instructions:
      - text: 'Merge these duplicate person profiles into one: {persons}.'
        slots:
          persons: requestBody.persons
      - text: Combine the profiles in {persons} that share the same email or external ID.
        slots:
          persons: requestBody.persons
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/persons/upsert'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or fully replace profiles by identifier
      effect: write
      questions:
      - Can I create people who don't exist yet and completely replace those who do, in one call?
      - What does a full upsert do to fields missing from a matched profile?
      instructions:
      - text: 'Fully upsert these person profiles, replacing any that match by external ID, email or phone: {persons}.'
        slots:
          persons: requestBody.persons
      - text: Create-or-replace the profiles {persons} in one full upsert batch.
        slots:
          persons: requestBody.persons
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/persons/upsert'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or partially update profiles by identifier
      effect: write
      questions:
      - Can I create missing people and only patch the fields I send on the ones that already exist?
      - Is there an upsert that preserves attributes I don't include?
      instructions:
      - text: 'Partially upsert these person profiles, keeping unsent fields on matches: {persons}.'
        slots:
          persons: requestBody.persons
      - text: Create-or-patch the profiles {persons}, matching on external ID, email or phone.
        slots:
          persons: requestBody.persons
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one company or list companies
      effect: read
      questions:
      - How do I find a company in People by its domain or name?
      - Can I list all the companies I've stored, with a filter?
      instructions:
      - text: Get the company named {name}.
        slots:
          name: query.name
      - text: Look up the company with domain {domain}.
        slots:
          domain: query.domain
      - text: List companies matching {filter}, page {page}.
        slots:
          filter: query.filter
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a company record
      effect: write
      questions:
      - Can I add a new B2B account as a company in People?
      - What details can I store on a company, like industry, VAT number or account manager?
      instructions:
      - text: Create a company called {name} in the {industry} industry.
        slots:
          name: requestBody.name
          industry: requestBody.industry
      - text: Add a company {name} with domains {domains} and VAT number {vatNumber}.
        slots:
          name: requestBody.name
          domains: requestBody.domains
          vatNumber: requestBody.vatNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a company record
      effect: destructive
      questions:
      - Can I delete a single company from People by its external ID?
      - Which lookup fields can I use to remove one company?
      instructions:
      - text: Delete the company with ID {id}.
        slots:
          id: query.id
      - text: Remove the company whose domain is {domain}.
        slots:
          domain: query.domain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update part of a company record
      effect: write
      questions:
      - Can I change a company's customer stage without resending its whole record?
      - Is it possible to replace a company's domains or tags rather than add to them?
      instructions:
      - text: Update the company with external ID {externalId} so its customer stage is {customerStage}.
        slots:
          externalId: query.externalId
          customerStage: requestBody.customerStage
      - text: Rename company {id} to {name}.
        slots:
          id: query.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Create many companies at once
      effect: write
      questions:
      - Can I bulk-create a thousand company records in one request?
      - What's the batch limit when importing companies?
      instructions:
      - text: 'Bulk-create these companies: {companies}.'
        slots:
          companies: requestBody.companies
      - text: 'Import all of these company records in one batch: {companies}.'
        slots:
          companies: requestBody.companies
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies/batch'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many companies at once
      effect: destructive
      questions:
      - Can I bulk-remove a list of companies from People?
      - What is the maximum number of companies one batch delete accepts?
      instructions:
      - text: 'Bulk-delete these companies: {companies}.'
        slots:
          companies: requestBody.companies
      - text: 'Remove all of these company records in a single batch: {companies}.'
        slots:
          companies: requestBody.companies
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies/batch'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update many companies at once
      effect: write
      questions:
      - Can I update many company records in a single call?
      - Is there a bulk edit for companies, and what's its size cap?
      instructions:
      - text: 'Bulk-update these companies with their new details: {companies}.'
        slots:
          companies: requestBody.companies
      - text: 'Apply these changes to many companies at once: {companies}.'
        slots:
          companies: requestBody.companies
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies/persons'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink people from a company
      effect: destructive
      questions:
      - Can I detach several people from the company they're linked to?
      - How many persons can I remove from a company at once?
      instructions:
      - text: Remove the people {people} from the company with ID {id}.
        slots:
          people: requestBody.people
          id: query.id
      - text: Unlink {people} from the company named {name}.
        slots:
          people: requestBody.people
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/companies/persons'].patch
  update:
    x-apievangelist-phrasing:
      intent: Link people to a company
      effect: write
      questions:
      - Can I associate a group of contacts with a company account?
      - What's the limit on adding persons to a company in one go?
      instructions:
      - text: Add the people {people} to the company with ID {id}.
        slots:
          people: requestBody.people
          id: query.id
      - text: Link {people} to the company with domain {domain}.
        slots:
          people: requestBody.people
          domain: query.domain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List People tags
      effect: read
      questions:
      - What tags have been created for segmenting people profiles?
      - Can I page through all People tags and get a total count?
      instructions:
      - text: List all People tags.
      - text: Show People tags page {page}, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a People tag
      effect: write
      questions:
      - Can I create a new tag to label people profiles?
      - Where do I define a tag before assigning it to persons?
      instructions:
      - text: Create a People tag named {name}.
        slots:
          name: requestBody.name
      - text: Add a new profile tag called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a People tag
      effect: read
      questions:
      - Can I check whether a particular People tag exists?
      - When was a given profile tag created or last modified?
      instructions:
      - text: Get the People tag {name}.
        slots:
          name: path.name
      - text: Show details of the profile tag called {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a People tag
      effect: destructive
      questions:
      - Can I delete a profile tag I no longer use?
      - Is there a way to remove a People tag entirely?
      instructions:
      - text: Delete the People tag {name}.
        slots:
          name: path.name
      - text: Remove the profile tag called {name} for good.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags/{name}/persons'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a tag from many people
      effect: destructive
      questions:
      - Can I take a tag off many people profiles at once?
      - How many persons can I untag in one batch?
      instructions:
      - text: 'Remove the tag {name} from these people: {people}.'
        slots:
          name: path.name
          people: requestBody.people
      - text: Strip the profile tag {name} off {people}.
        slots:
          name: path.name
          people: requestBody.people
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/tags/{name}/persons'].patch
  update:
    x-apievangelist-phrasing:
      intent: Assign a tag to many people
      effect: write
      questions:
      - Can I apply one tag to a thousand people profiles in a single call?
      - How do I bulk-tag a group of contacts?
      instructions:
      - text: 'Assign the tag {name} to these people: {people}.'
        slots:
          name: path.name
          people: requestBody.people
      - text: Tag {people} with {name}.
        slots:
          people: requestBody.people
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/customAttributes'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom attributes
      effect: read
      questions:
      - Which custom attributes are defined on people profiles?
      - Can I page through all custom profile fields and their data types?
      instructions:
      - text: List all custom attributes defined in People.
      - text: Show custom attributes page {page}, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/customAttributes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom attribute
      effect: write
      questions:
      - Can I add a custom field like loyalty tier to people profiles?
      - What data types can a new custom attribute have?
      instructions:
      - text: Create a custom attribute {name} with data type {dataType}.
        slots:
          name: requestBody.name
          dataType: requestBody.dataType
      - text: Add a custom profile field called {name} of type {dataType}.
        slots:
          name: requestBody.name
          dataType: requestBody.dataType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/customAttributes/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom attribute
      effect: read
      questions:
      - Can I see the definition and data type of one custom attribute?
      - What schema does a particular custom profile field use?
      instructions:
      - text: Get the custom attribute {name}.
        slots:
          name: path.name
      - text: Show the definition of custom field {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/customAttributes/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom attribute
      effect: destructive
      questions:
      - Can I remove a custom attribute definition from People?
      - Is it possible to drop a custom profile field I no longer need?
      instructions:
      - text: Delete the custom attribute {name}.
        slots:
          name: path.name
      - text: Remove the custom profile field {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/2/customAttributes/{name}/append'].post
  update:
    x-apievangelist-phrasing:
      intent: Append an item to a list-of-objects attribute
      effect: write
      questions:
      - Can I add one new object to a person's LIST_OF_OBJECTS custom attribute?
      - How would I push an extra purchase record into a person's list-type field?
      instructions:
      - text: Append a new item to custom attribute {name} for person {identifier}.
        slots:
          name: path.name
          identifier: query.identifier
      - text: Add an entry to the list-of-objects field {name} on the person with {type} identifier {identifier}.
        slots:
          name: path.name
          type: query.type
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}/items'].get
  update:
    x-apievangelist-phrasing:
      intent: Get items from a person's list attribute
      effect: read
      questions:
      - Can I fetch specific items from a list attribute on a person identified by email or phone?
      - Which items does a person's list attribute hold right now?
      instructions:
      - text: Get items {itemIds} from list {listName} of the person with {type} identifier {identifier}.
        slots:
          itemIds: query.itemIds
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Show the items {itemIds} in list attribute {listName} for person {identifier}.
        slots:
          itemIds: query.itemIds
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Add items to a person's list attribute
      effect: write
      questions:
      - Can I add new items to a list attribute on a profile looked up by identifier?
      - Does appending to a list attribute return the whole updated list?
      instructions:
      - text: Append items to list {listName} of the person with {type} identifier {identifier}.
        slots:
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Add new entries to the {listName} list attribute for person {identifier}.
        slots:
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}/items'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete items from a person's list attribute
      effect: destructive
      questions:
      - Can I delete certain entries from a person's list attribute by item ID?
      - What's returned after removing items from a list attribute?
      instructions:
      - text: Delete items {itemIds} from list {listName} of the person with {type} identifier {identifier}.
        slots:
          itemIds: query.itemIds
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Remove entries {itemIds} from the {listName} list attribute on person {identifier}.
        slots:
          itemIds: query.itemIds
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}/items/{itemId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace one item in a person's list attribute
      effect: write
      questions:
      - Can I swap out a single item in a list attribute with a completely new version?
      - Is replacing a list item different from patching its fields?
      instructions:
      - text: Replace item {itemId} in list {listName} for the person with {type} identifier {identifier}.
        slots:
          itemId: path.itemId
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Fully overwrite list attribute item {itemId} of {listName} on person {identifier}.
        slots:
          itemId: path.itemId
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}/items/{itemId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update fields of one list attribute item
      effect: write
      questions:
      - Can I change just one field of a list attribute item and keep its other values?
      - What happens to fields I omit when patching a single list item?
      instructions:
      - text: Update only the sent fields of item {itemId} in list {listName} for the person with {type} identifier {identifier}.
        slots:
          itemId: path.itemId
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Patch list attribute item {itemId} of {listName} on person {identifier}.
        slots:
          itemId: path.itemId
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a person's list attributes
      effect: read
      questions:
      - Can I retrieve several list attributes of one profile at once?
      - What are all the items in a person's list-type attributes?
      instructions:
      - text: Get the list attributes {listNames} of the person with {type} identifier {identifier}.
        slots:
          listNames: query.listNames
          type: query.type
          identifier: query.identifier
      - text: Show every item in lists {listNames} for person {identifier}.
        slots:
          listNames: query.listNames
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a person's list attributes
      effect: destructive
      questions:
      - Can I wipe entire list attributes from a profile in one call?
      - Is there a way to clear several list attributes on one person?
      instructions:
      - text: Delete the list attributes {listNames} from the person with {type} identifier {identifier}.
        slots:
          listNames: query.listNames
          type: query.type
          identifier: query.identifier
      - text: Clear out lists {listNames} entirely on person {identifier}.
        slots:
          listNames: query.listNames
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all items in a person's list attribute
      effect: write
      questions:
      - Can I overwrite every item in a person's list attribute with a new set?
      - Does replacing a list attribute drop items I don't resend?
      instructions:
      - text: Replace all items in list {listName} of the person with {type} identifier {identifier}.
        slots:
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Overwrite the whole {listName} list attribute on person {identifier} with new items.
        slots:
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/people/3/lists/{listName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update items in a person's list attribute
      effect: write
      questions:
      - Can I patch several items of a list attribute while leaving missing items alone?
      - What happens to list items I don't include in a list-level update?
      instructions:
      - text: Update the sent items and fields of list {listName} for the person with {type} identifier {identifier}.
        slots:
          listName: path.listName
          type: query.type
          identifier: query.identifier
      - text: Patch multiple entries of the {listName} list attribute on person {identifier}, keeping the rest.
        slots:
          listName: path.listName
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (174 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/infobip/refs/heads/main/overlays/infobip-customer-engagement-api-phrasing-overlay.yaml