# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Signatures API
  version: 1.0.0
extends: openapi/nylas-signatures-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}/signatures'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's email signatures
      effect: read
      questions:
      - Which email signatures has this user saved?
      - How do I page through a grant's signatures?
      instructions:
      - text: List signatures for grant {grant_id}.
        slots:
          grant_id: path.grant_id
      - text: Show all saved signatures in mailbox {grant_id}.
        slots:
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/signatures'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an email signature
      effect: write
      questions:
      - How many signatures can one user have?
      - Can I use inline base64 images in a new signature?
      instructions:
      - text: Create a signature {name} for grant {grant_id} with HTML {body}.
        slots:
          name: requestBody.name
          grant_id: path.grant_id
          body: requestBody.body
      - text: Add a new signature called {name} to mailbox {grant_id} using {body}.
        slots:
          name: requestBody.name
          grant_id: path.grant_id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/signatures/{signature_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one email signature
      effect: read
      questions:
      - How can I view the HTML of a specific signature?
      - Can I fetch a signature by its ID?
      instructions:
      - text: Get signature {signature_id} for grant {grant_id}.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
      - text: Show me the content of signature {signature_id} in mailbox {grant_id}.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/signatures/{signature_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an email signature
      effect: write
      questions:
      - Does a signature keep its ID when I edit it?
      - Can I rename a signature or change its body?
      instructions:
      - text: Rename signature {signature_id} on grant {grant_id} to {name}.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
          name: requestBody.name
      - text: Replace the body of signature {signature_id} in {grant_id} with {body}.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/signatures/{signature_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email signature
      effect: destructive
      questions:
      - How do I permanently remove a saved signature?
      - Are signatures removed automatically when a grant is deleted?
      instructions:
      - text: Delete signature {signature_id} from grant {grant_id}.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
      - text: Remove saved signature {signature_id} in mailbox {grant_id} permanently.
        slots:
          signature_id: path.signature_id
          grant_id: path.grant_id
      method: generated
      generated: '2026-09-26'