# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Contentstack Personalize Edge User Attributes API
  version: 1.0.0
extends: openapi/contentstack-user-attributes-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['/user-attributes'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set attributes on a visitor
      effect: write
      questions:
      - How do I store profile data about a visitor for audience targeting?
      - Can I push attributes from my CRM onto a Personalize user?
      instructions:
      - text: Set attributes for user {user} in project {project}.
        slots:
          user: header.x-cs-personalize-user-uid
          project: header.x-project-uid
      - text: Save custom attribute values for visitor {user} at the Personalize Edge in project {project}.
        slots:
          user: header.x-cs-personalize-user-uid
          project: header.x-project-uid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user-attributes/actions/merge'].post
  update:
    x-apievangelist-phrasing:
      intent: Merge an anonymous visitor into a known user
      effect: write
      questions:
      - How do I combine an anonymous visitor's data with their account after login?
      - Can I keep behavioral data when an anonymous user signs in?
      instructions:
      - text: Merge user {source} into user {target} in project {project}.
        slots:
          source: requestBody.sourceUserUid
          target: requestBody.targetUserUid
          project: header.x-project-uid
      - text: Merge anonymous visitor {source} into logged-in user {target} for Personalize project {project}.
        slots:
          source: requestBody.sourceUserUid
          target: requestBody.targetUserUid
          project: header.x-project-uid
      method: generated
      generated: '2026-09-26'