# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Configurations API
  version: 1.0.0
extends: openapi/nylas-configurations-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['/v3/grants/{grant_id}/scheduling/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List scheduling Configurations
      effect: read
      questions:
      - What scheduling pages and Configurations does this user have?
      - Can I page through a grant's scheduler Configurations?
      instructions:
      - text: List scheduling Configurations for grant {grant}.
        slots:
          grant: path.grant_id
      - text: Show all scheduler Configurations on {grant}.
        slots:
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a scheduling Configuration
      effect: write
      questions:
      - How do I set up a new booking page with its own scheduling rules?
      - Why might Microsoft organizers get duplicate booking emails?
      instructions:
      - text: Create a scheduling Configuration for grant {grant}.
        slots:
          grant: path.grant_id
      - text: Set up a new booking Configuration on {grant}.
        slots:
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one scheduling Configuration
      effect: read
      questions:
      - What rules and participants are on a specific scheduling Configuration?
      - Can I retrieve a single Configuration by its ID?
      instructions:
      - text: Show Configuration {configuration} for grant {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      - text: Get the settings of scheduling Configuration {configuration} on {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a scheduling Configuration
      effect: write
      questions:
      - Can I change the settings of an existing booking page?
      - Does updating a Configuration replace its nested objects?
      instructions:
      - text: Update scheduling Configuration {configuration} on grant {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      - text: Change the settings of Configuration {configuration} for {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/scheduling/configurations/{configuration_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a scheduling Configuration
      effect: destructive
      questions:
      - Can I delete a Configuration that still has active sessions?
      - How do I remove a booking page I no longer use?
      instructions:
      - text: Delete Configuration {configuration} from grant {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      - text: Remove scheduling Configuration {configuration} on {grant}.
        slots:
          configuration: path.configuration_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'