# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cvent REST Attendee Activities API
  version: 1.0.0
extends: openapi/cvent-event-cloud-attendee-activities-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: 6
- target: $.paths['/attendees/activities'].get
  update:
    x-apievangelist-phrasing:
      intent: List attendee activities
      effect: read
      questions:
      - What have attendees been doing, like page visits and session joins?
      - Can I pull attendee activities recorded after a specific time?
      instructions:
      - text: List attendee activities.
      - text: List attendee activities after {after} matching {filter}.
        slots:
          after: query.after
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attendees/activities'].post
  update:
    x-apievangelist-phrasing:
      intent: Record an external activity for an attendee
      effect: write
      questions:
      - How do I log something an attendee did in another system as a Cvent activity?
      - Can I push activity from an outside app into an attendee's timeline?
      instructions:
      - text: Record external activity {name} of type {type} for attendee {attendee} at event {event}.
        slots:
          name: requestBody.name
          type: requestBody.type
          attendee: requestBody.attendee
          event: requestBody.event
      - text: Log an external {type} activity for attendee {attendee} with data {data}.
        slots:
          type: requestBody.type
          attendee: requestBody.attendee
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attendees/activities/external/metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List external activity type definitions
      effect: read
      questions:
      - Which external activity types have been defined for attendee tracking?
      - Can I see the metadata describing my external attendee activities?
      instructions:
      - text: List external attendee activity metadata.
      - text: List external activity definitions matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attendees/activities/external/metadata'].post
  update:
    x-apievangelist-phrasing:
      intent: Define a new external activity type
      effect: write
      questions:
      - How do I define a new kind of external attendee activity before logging it?
      - Can I describe the fields an external activity type will carry?
      instructions:
      - text: Define external activity type {type} named {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Create external activity metadata {name} of type {type} with fields {fields}.
        slots:
          name: requestBody.name
          type: requestBody.type
          fields: requestBody.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attendees/activities/external/metadata/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an external activity type definition
      effect: write
      questions:
      - How do I change the name or fields of an existing external activity type?
      - Can I edit the description of external activity metadata?
      instructions:
      - text: Update external activity metadata {id} with name {name} and type {type}.
        slots:
          id: path.id
          name: requestBody.name
          type: requestBody.type
      - text: Change the fields on existing external activity definition {id} to {fields}.
        slots:
          id: path.id
          fields: requestBody.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attendees/activities/external/metadata/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an external activity type definition
      effect: destructive
      questions:
      - How do I remove an external activity type I no longer use?
      - Can I delete external attendee activity metadata?
      instructions:
      - text: Delete external activity metadata {id}.
        slots:
          id: path.id
      - text: Remove external activity definition {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'