# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Anthropic User Profiles API
  version: 1.0.0
extends: openapi/anthropic-user-profiles-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: 5
- target: $.paths['/v1/user_profiles/{user_profile_id}/enrollment_url?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an enrollment link for a user profile
      effect: write
      questions:
      - How do I get a link that lets one of my end users enroll their profile?
      - Can I generate a fresh enrollment URL for an existing user profile?
      instructions:
      - text: Create an enrollment URL for user profile {user_profile_id}.
        slots:
          user_profile_id: path.user_profile_id
      - text: Generate a sign-up link I can send to profile {user_profile_id}.
        slots:
          user_profile_id: path.user_profile_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/user_profiles/{user_profile_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user profile
      effect: read
      questions:
      - What details are stored on one of my user profiles?
      - Can I check a user profile's access type and relationship?
      instructions:
      - text: Get user profile {user_profile_id}.
        slots:
          user_profile_id: path.user_profile_id
      - text: Show the name, relationship and access type of profile {user_profile_id}.
        slots:
          user_profile_id: path.user_profile_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/user_profiles/{user_profile_id}?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a user profile's name or access
      effect: write
      questions:
      - How do I change the access type on an existing user profile?
      - Can I update a profile's external ID or metadata?
      instructions:
      - text: Rename user profile {user_profile_id} to {name}.
        slots:
          user_profile_id: path.user_profile_id
          name: requestBody.name
      - text: Change profile {user_profile_id} access type to {access_type}.
        slots:
          user_profile_id: path.user_profile_id
          access_type: requestBody.access_type
      - text: Link profile {user_profile_id} to my system's ID {external_id}.
        slots:
          user_profile_id: path.user_profile_id
          external_id: requestBody.external_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/user_profiles?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List user profiles
      effect: read
      questions:
      - Which user profiles have I created?
      - Can I list user profiles oldest first?
      instructions:
      - text: List my user profiles.
      - text: Show {limit} user profiles per page in {order} order.
        slots:
          limit: query.limit
          order: query.order
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/user_profiles?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user profile for an end user
      effect: write
      questions:
      - How do I register one of my end users as a user profile?
      - Can I tie a new user profile to an ID from my own system?
      instructions:
      - text: Create a user profile named {name} with external ID {external_id}.
        slots:
          name: requestBody.name
          external_id: requestBody.external_id
      - text: Add a new profile for {name} with relationship {relationship} and access type {access_type}.
        slots:
          name: requestBody.name
          relationship: requestBody.relationship
          access_type: requestBody.access_type
      method: generated
      generated: '2026-09-26'