# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Request Logs API
  version: 1.0.0
extends: openapi/docusign-requestlogs-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v2/diagnostics/request_logs'].get
  update:
    x-apievangelist-phrasing:
      intent: List API request log entries
      effect: read
      questions:
      - Can I download my recent API request logs for troubleshooting?
      - Can request logs come back as a zip file instead of JSON?
      instructions:
      - text: List my API request log entries.
      - text: Download the API request logs with encoding {encoding}.
        slots:
          encoding: query.encoding
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/diagnostics/request_logs'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all API request logs
      effect: destructive
      questions:
      - Can I wipe out all the captured API request logs?
      - Is there a way to reset the request log before a new debugging session?
      instructions:
      - text: Delete all of my API request log files.
      - text: Clear the API request log.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/diagnostics/request_logs/{requestLogId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single API request log entry
      effect: read
      questions:
      - Can I view the full request and response of one logged API call?
      - Where do I find the ID of a single logged request?
      instructions:
      - text: Show API request log entry {requestLogId}.
        slots:
          requestLogId: path.requestLogId
      - text: Get the request and response captured in log {requestLogId}.
        slots:
          requestLogId: path.requestLogId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/diagnostics/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Check API request logging settings
      effect: read
      questions:
      - Is API request logging currently turned on for me?
      - How many log entries do I have remaining?
      instructions:
      - text: Show my API request logging settings.
      - text: Check how many request log entries remain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/diagnostics/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn API request logging on or off
      effect: write
      questions:
      - Can I enable request logging to troubleshoot my integration?
      - What is the maximum number of requests the log can hold?
      instructions:
      - text: Set API request logging to {apiRequestLogging}.
        slots:
          apiRequestLogging: requestBody.apiRequestLogging
      - text: Enable request logging with a maximum of {apiRequestLogMaxEntries} entries.
        slots:
          apiRequestLogMaxEntries: requestBody.apiRequestLogMaxEntries
      method: generated
      generated: '2026-10-01'