API Evangelist conversational phrasing for Blnk Identities API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Blnk Identities API
  version: 1.0.0
extends: openapi/blnkfinance-identities-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/identities'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a customer or business identity
      effect: write
      questions:
      - How do I add a new customer or organization record with an address in Blnk?
      - What address fields are needed when registering a new identity?
      - Can I attach custom metadata when creating an identity?
      instructions:
      - text: Create a {identity_type} identity named {name} in category {category} at {street}, {city}, {state} {post_code}, {country}.
        slots:
          identity_type: requestBody.identity_type
          name: requestBody.name
          category: requestBody.category
          street: requestBody.street
          city: requestBody.city
          state: requestBody.state
          post_code: requestBody.post_code
          country: requestBody.country
      - text: Register new identity {name} with metadata {meta_data}.
        slots:
          name: requestBody.name
          meta_data: requestBody.meta_data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an identity's profile
      effect: read
      questions:
      - Where do I see the stored name, address and contact details for an identity ID?
      - Can I retrieve the profile of the person behind an account?
      instructions:
      - text: Show me identity {id}.
        slots:
          id: path.id
      - text: Pull the profile and address on file for identity {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/identities/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a person's identity details
      effect: write
      questions:
      - How do I change the email address or phone number on an existing identity?
      - Can I record date of birth, gender and nationality on an identity I already created?
      instructions:
      - text: Update identity {id} with email {email_address} and phone {phone_number}.
        slots:
          id: path.id
          email_address: requestBody.email_address
          phone_number: requestBody.phone_number
      - text: Set the name on existing identity {id} to {first_name} {last_name}, born {dob}.
        slots:
          id: path.id
          first_name: requestBody.first_name
          last_name: requestBody.last_name
          dob: requestBody.dob
      - text: Change the address of identity {id} to {street}, {city}, {country}.
        slots:
          id: path.id
          street: requestBody.street
          city: requestBody.city
          country: requestBody.country
      method: generated
      generated: '2026-10-01'