# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Email Drafts API
  version: 1.0.0
extends: openapi/zoho-crm-email-drafts-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['/{module}/{record}/__email_drafts'].get
  update:
    x-apievangelist-phrasing:
      intent: List email drafts on a record
      effect: read
      questions:
      - What email drafts are saved against a given contact?
      - Can I page through the email drafts on a deal?
      instructions:
      - text: List email drafts for {module} record {record}.
        slots:
          module: path.module
          record: path.record
      - text: Show saved drafts on record {record} in {module}, {per_page} per page.
        slots:
          module: path.module
          record: path.record
          per_page: query.per_page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{module}/{record}/__email_drafts'].post
  update:
    x-apievangelist-phrasing:
      intent: Save an email draft on a record
      effect: write
      questions:
      - How do I save an unsent email as a draft on a lead?
      - Can I create several email drafts for one record at once?
      instructions:
      - text: Create email draft {__email_drafts} on {module} record {record}.
        slots:
          module: path.module
          record: path.record
          __email_drafts: requestBody.__email_drafts
      - text: Save a new email draft on record {record} in {module}.
        slots:
          module: path.module
          record: path.record
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{module}/{record}/__email_drafts/{draft}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one email draft
      effect: read
      questions:
      - How do I open a specific saved email draft?
      - What's in a particular draft saved on a contact?
      instructions:
      - text: Get email draft {draft} on {module} record {record}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
      - text: Show draft {draft} of record {record} in {module}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{module}/{record}/__email_drafts/{draft}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an email draft
      effect: write
      questions:
      - How do I change the subject or body of a saved email draft?
      - Can I edit an existing draft before sending it?
      instructions:
      - text: Update email draft {draft} on {module} record {record} with {__email_drafts}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
          __email_drafts: requestBody.__email_drafts
      - text: Edit draft {draft} on record {record} in {module}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{module}/{record}/__email_drafts/{draft}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email draft
      effect: destructive
      questions:
      - How do I discard a saved email draft?
      - Can I delete one draft from a record without affecting sent emails?
      instructions:
      - text: Delete email draft {draft} from {module} record {record}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
      - text: Discard draft {draft} on record {record} in {module}.
        slots:
          module: path.module
          record: path.record
          draft: path.draft
      method: generated
      generated: '2026-09-26'