API Evangelist conversational phrasing for Nylas Standalone Notetaker API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Standalone Notetaker API
  version: 1.0.0
extends: openapi/nylas-standalone-notetaker-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: 9
- target: $.paths['/v3/notetakers'].get
  update:
    x-apievangelist-phrasing:
      intent: List standalone meeting Notetaker bots
      effect: read
      questions:
      - Which Notetaker bots have I invited to meetings?
      - Can I filter my standalone Notetakers by state, like only the ones currently in a meeting?
      - How do I list Notetakers scheduled to join within a time window?
      instructions:
      - text: List standalone Notetakers in state {state}.
        slots:
          state: query.state
      - text: Show Notetakers joining between {join_time_start} and {join_time_end}.
        slots:
          join_time_start: query.join_time_start
          join_time_end: query.join_time_end
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a Notetaker bot to a meeting
      effect: write
      questions:
      - How do I send a bot to record and transcribe a video meeting?
      - Can I schedule a Notetaker to join a meeting at a specific time?
      - Does inviting the Notetaker twice create two bots in the same meeting?
      instructions:
      - text: Invite a Notetaker to the meeting at {meeting_link}.
        slots:
          meeting_link: requestBody.meeting_link
      - text: Send a Notetaker named {name} to {meeting_link} at {join_time}.
        slots:
          name: requestBody.name
          meeting_link: requestBody.meeting_link
          join_time: requestBody.join_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a standalone Notetaker's details
      effect: read
      questions:
      - How can I see the current state and settings of a Notetaker I invited?
      - Can I check which meeting a particular Notetaker bot is assigned to?
      instructions:
      - text: Get details for Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      - text: Show me the status of standalone Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a Notetaker and its data
      effect: destructive
      questions:
      - How do I erase a Notetaker along with its recordings and transcripts?
      - Can I permanently delete a Notetaker's summaries and action items even while it's active?
      instructions:
      - text: Permanently delete Notetaker {notetaker_id} and all of its recordings.
        slots:
          notetaker_id: path.notetaker_id
      - text: Wipe the transcripts and media for standalone Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a scheduled Notetaker's settings
      effect: write
      questions:
      - Can I change the join time of a Notetaker that's already scheduled?
      - How do I rename a scheduled Notetaker bot or change its meeting settings?
      instructions:
      - text: Move Notetaker {notetaker_id} to join at {join_time}.
        slots:
          notetaker_id: path.notetaker_id
          join_time: requestBody.join_time
      - text: Rename scheduled Notetaker {notetaker_id} to {name}.
        slots:
          notetaker_id: path.notetaker_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a Notetaker's event and state history
      effect: read
      questions:
      - How can I see every state change a Notetaker went through during a meeting?
      - Is there an audit trail of when a Notetaker bot joined and left?
      instructions:
      - text: Show the full history for Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      - text: List the state changes of standalone Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}/cancel'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a Notetaker before it joins the meeting
      effect: destructive
      questions:
      - How do I stop a scheduled Notetaker from joining a meeting?
      - Can I call off a Notetaker that's still waiting in the meeting lobby?
      instructions:
      - text: Cancel Notetaker {notetaker_id} before it joins the call.
        slots:
          notetaker_id: path.notetaker_id
      - text: Call off scheduled standalone Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}/leave'].post
  update:
    x-apievangelist-phrasing:
      intent: Make a Notetaker leave a meeting in progress
      effect: write
      questions:
      - How do I remove the recording bot from a meeting that's already underway?
      - Can I tell a Notetaker to leave the call early?
      instructions:
      - text: Tell Notetaker {notetaker_id} to leave its current meeting.
        slots:
          notetaker_id: path.notetaker_id
      - text: Remove standalone Notetaker {notetaker_id} from the call now.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/notetakers/{notetaker_id}/media'].get
  update:
    x-apievangelist-phrasing:
      intent: Get recording and transcript links from a Notetaker
      effect: read
      questions:
      - Where do I download the recording and transcript a Notetaker produced?
      - Can I get links to all the media generated for a meeting bot?
      instructions:
      - text: Get the media links for Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      - text: Fetch the recording and transcript URLs from standalone Notetaker {notetaker_id}.
        slots:
          notetaker_id: path.notetaker_id
      method: generated
      generated: '2026-09-26'