# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Drafts API
  version: 1.0.0
extends: openapi/nylas-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: 6
- target: $.paths['/v3/grants/{grant_id}/drafts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's email drafts
      effect: read
      questions:
      - How do I see all the drafts sitting in a user's Drafts folder?
      - Can I filter drafts by recipient or subject?
      instructions:
      - text: List the drafts in mailbox {grant_id}.
        slots:
          grant_id: path.grant_id
      - text: Find drafts in {grant_id} addressed to {to}.
        slots:
          grant_id: path.grant_id
          to: query.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/drafts'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a new email draft
      effect: write
      questions:
      - Can I save an email as a draft without sending it?
      - Is it possible to create a draft reply to an existing message?
      instructions:
      - text: Create a draft in {grant_id} to {to} with subject {subject}.
        slots:
          grant_id: path.grant_id
          to: requestBody.to
          subject: requestBody.subject
      - text: Save a draft reply to message {reply_to_message_id} in mailbox {grant_id}.
        slots:
          reply_to_message_id: requestBody.reply_to_message_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/drafts/{draft_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a single email draft
      effect: read
      questions:
      - How can I open one specific draft to check its contents?
      - Can I look up a draft by its ID?
      instructions:
      - text: Get draft {draft_id} from mailbox {grant_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
      - text: Show me the contents of draft {draft_id} for grant {grant_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/drafts/{draft_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an existing email draft
      effect: write
      questions:
      - Can I change the recipients or body of a draft I already saved?
      - What happens to nested fields when I update a draft?
      instructions:
      - text: Change the subject of draft {draft_id} in {grant_id} to {subject}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
          subject: requestBody.subject
      - text: Rewrite the body of draft {draft_id} for grant {grant_id} as {body}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/drafts/{draft_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a saved draft
      effect: write
      questions:
      - How do I send an email that's currently saved as a draft?
      - Can I attach a signature to a draft at the moment I send it?
      instructions:
      - text: Send draft {draft_id} from mailbox {grant_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
      - text: Send saved draft {draft_id} for {grant_id} with signature {signature_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
          signature_id: requestBody.signature_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/drafts/{draft_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email draft
      effect: destructive
      questions:
      - How do I throw away a draft I don't need?
      - Is deleting a draft permanent?
      instructions:
      - text: Delete draft {draft_id} from mailbox {grant_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
      - text: Discard unsent draft {draft_id} for grant {grant_id}.
        slots:
          draft_id: path.draft_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'