# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Oracle Siebel REST Activities API
  version: 1.0.0
extends: openapi/oracle-siebel-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: 5
- target: $.paths['/data/Activity/Activity'].get
  update:
    x-apievangelist-phrasing:
      intent: List activities
      effect: read
      questions:
      - How can I see all the tasks, calls and appointments logged in Siebel?
      - Can I filter activities by status or due date with a search spec?
      - Which activities are visible to me in personal view mode?
      instructions:
      - text: List all activities.
      - text: List activities matching {searchspec}.
        slots:
          searchspec: query.searchspec
      - text: Show activities in {view_mode} view, {page_size} per page.
        slots:
          view_mode: query.ViewMode
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/Activity/Activity'].post
  update:
    x-apievangelist-phrasing:
      intent: Log a new activity
      effect: write
      questions:
      - How do I log a new call or task in the CRM?
      - Can I set a due date and priority when I create an activity?
      - What's the minimum I need to create an activity record?
      instructions:
      - text: 'Create a {type} activity: {description}.'
        slots:
          type: requestBody.Type
          description: requestBody.Description
      - text: 'Log a {type} activity for account {account} due {due}: {description}.'
        slots:
          type: requestBody.Type
          account: requestBody.Account
          due: requestBody.Due
          description: requestBody.Description
      - text: 'Add a {priority} priority {type} activity: {description}.'
        slots:
          priority: requestBody.Priority
          type: requestBody.Type
          description: requestBody.Description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/Activity/Activity/{ActivityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one activity by its ID
      effect: read
      questions:
      - How do I pull up the details of one specific activity?
      - Can I retrieve just a few fields from a single activity record?
      instructions:
      - text: Get activity {activity_id}.
        slots:
          activity_id: path.ActivityId
      - text: Show the {fields} of activity {activity_id}.
        slots:
          fields: query.fields
          activity_id: path.ActivityId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/Activity/Activity/{ActivityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or insert an activity by ID
      effect: write
      questions:
      - How do I mark an existing activity as done?
      - Can I reschedule an activity by changing its due date?
      - What happens if I upsert an activity ID that doesn't exist?
      instructions:
      - text: 'Set activity {activity_id} ({type}: {description}) to status {status}.'
        slots:
          activity_id: path.ActivityId
          type: requestBody.Type
          description: requestBody.Description
          status: requestBody.Status
      - text: 'Move activity {activity_id} ({type}: {description}) due date to {due}.'
        slots:
          activity_id: path.ActivityId
          type: requestBody.Type
          description: requestBody.Description
          due: requestBody.Due
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/Activity/Activity/{ActivityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an activity
      effect: destructive
      questions:
      - How do I remove an activity that was logged by mistake?
      - Can I delete a single activity record by its row ID?
      instructions:
      - text: Delete activity {activity_id}.
        slots:
          activity_id: path.ActivityId
      - text: Remove the activity with row ID {activity_id}.
        slots:
          activity_id: path.ActivityId
      method: generated
      generated: '2026-09-26'