# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Regal Events API
  version: 1.0.0
extends: openapi/regal-ai-events-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: 1
- target: $.paths['/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a custom event for a contact
      effect: write
      questions:
      - How do I send a custom event to Regal to trigger a Journey for a contact?
      - Can posting an event create or update the contact's profile at the same time?
      - What does a contact need so they are considered contactable after an event?
      instructions:
      - text: Record event {name} for the contact with traits {traits}.
        slots:
          name: requestBody.name
          traits: requestBody.traits
      - text: Send custom event {name} from {eventSource} for contact {traits} with properties {properties}.
        slots:
          name: requestBody.name
          eventSource: requestBody.eventSource
          traits: requestBody.traits
          properties: requestBody.properties
      - text: Upsert the contact with traits {traits} and external ID {userId}.
        slots:
          traits: requestBody.traits
          userId: requestBody.userId
      method: generated
      generated: '2026-09-26'