# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Live Direct Marketing Online Admin API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-admin-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: 139
- target: $.paths['/api/admin/tests/{token}/reanalyze'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run analysis of an inbox placement test
      effect: write
      questions:
      - Can I recompute the analysis of a test without losing its placement and delivery timestamps?
      - What happens to the original received copy when an admin reanalyzes a test?
      instructions:
      - text: Reanalyze inbox test {token} from its original received copy.
        slots:
          token: path.token
      - text: Recompute the analysis for test {token} but keep its placement results.
        slots:
          token: path.token
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/feedback'].get
  update:
    x-apievangelist-phrasing:
      intent: List user feedback submissions
      effect: read
      questions:
      - Where can an admin read the feedback users have submitted?
      - Can I page through feedback entries with limit and offset?
      instructions:
      - text: Show the latest {limit} feedback submissions.
        slots:
          limit: query.limit
      - text: List feedback entries starting at offset {offset}.
        slots:
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/feedback/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get feedback statistics
      effect: read
      questions:
      - How much user feedback has come in overall?
      - What do the aggregate feedback stats look like?
      instructions:
      - text: Give me the summary statistics for user feedback.
      - text: Report totals across all feedback submissions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/beta-signups'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta program signups
      effect: read
      questions:
      - Who has signed up for the beta?
      - Can I filter beta signups by platform?
      instructions:
      - text: List beta signups for the {platform} platform.
        slots:
          platform: query.platform
      - text: Show {limit} beta signups starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/beta-signups/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get beta signup statistics
      effect: read
      questions:
      - How many people have joined the beta so far?
      - What is the breakdown of beta signup numbers?
      instructions:
      - text: Summarize beta signup counts.
      - text: Pull the aggregate beta signups stats.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/screenshot-orders/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get screenshot order statistics
      effect: read
      questions:
      - How many screenshot orders were placed recently?
      - Can I see screenshot order stats over a chosen number of days?
      instructions:
      - text: Show screenshot order stats for the last {days} days.
        slots:
          days: query.days
      - text: Report screenshot order volume across the platform.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/recheck-jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List recheck jobs
      effect: read
      questions:
      - Which recheck jobs are queued or have failed?
      - Can I filter recheck jobs by status?
      instructions:
      - text: List recheck jobs with status {status}.
        slots:
          status: query.status
      - text: Show {limit} recheck jobs from offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/recheck-jobs/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get recheck job statistics
      effect: read
      questions:
      - How are recheck jobs performing in aggregate?
      - What totals exist for recheck jobs by outcome?
      instructions:
      - text: Summarize recheck job counts.
      - text: Give me the recheck jobs statistics overview.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get platform admin statistics
      effect: read
      questions:
      - What are the headline admin numbers for the whole platform?
      - Is there a single endpoint for overall admin dashboard stats?
      instructions:
      - text: Show the overall admin dashboard statistics.
      - text: Report platform-wide admin totals.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/slack/installations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Slack workspace installations
      effect: read
      questions:
      - Which Slack workspaces have installed the app?
      - Can I see every Slack installation as an admin?
      instructions:
      - text: List all Slack workspaces where the app is installed.
      - text: Show the Slack installations on the platform.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/deliverability/config'].get
  update:
    x-apievangelist-phrasing:
      intent: View deliverability control settings
      effect: read
      questions:
      - What is the current deliverability control configuration?
      - Where do I see the deliverability control settings in effect?
      instructions:
      - text: Show the current deliverability control config.
      - text: Read back the deliverability settings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/deliverability/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Change deliverability control settings
      effect: write
      questions:
      - Can I change the deliverability control configuration?
      - Is an admin actor recorded when deliverability settings are updated?
      instructions:
      - text: Update the deliverability control config as admin {actor}.
        slots:
          actor: header.x-admin-actor
      - text: Save new deliverability settings, attributing the change to {actor}.
        slots:
          actor: header.x-admin-actor
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List seed mailbox accounts
      effect: read
      questions:
      - Which seed mailboxes are used for inbox placement tests?
      - Can I filter seed accounts by mailbox provider or health?
      instructions:
      - text: List seed accounts on provider {provider}.
        slots:
          provider: query.provider
      - text: Show seeds with status {status} and health {health}.
        slots:
          status: query.status
          health: query.health
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a single seed account
      effect: write
      questions:
      - How do I add one new seed mailbox to the placement panel?
      - Can I register an individual seed account by hand?
      instructions:
      - text: Add a new seed mailbox account.
      - text: Register one more seed account for placement testing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/{id}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a seed account
      effect: write
      questions:
      - Can I take a seed mailbox out of rotation without deleting it?
      - What does archiving a seed account do?
      instructions:
      - text: Archive seed {id} as admin {actor}.
        slots:
          id: path.id
          actor: header.x-admin-actor
      - text: Retire seed account {id} from testing.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/{id}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an archived seed account
      effect: write
      questions:
      - Can an archived seed mailbox be brought back into use?
      - How do I un-archive a seed account?
      instructions:
      - text: Restore archived seed {id} as admin {actor}.
        slots:
          id: path.id
          actor: header.x-admin-actor
      - text: Put seed account {id} back into rotation.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/audit-log'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the admin audit log
      effect: read
      questions:
      - Who changed what in the admin console?
      - Can I filter admin audit entries by entity type or action?
      instructions:
      - text: Show admin audit log entries for {entityType} {entityId}.
        slots:
          entityType: query.entityType
          entityId: query.entityId
      - text: List the last {limit} audit entries with action {action}.
        slots:
          limit: query.limit
          action: query.action
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seed-health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check seed account health
      effect: read
      questions:
      - Are any seed mailboxes unhealthy right now?
      - What is the health summary across all seeds?
      instructions:
      - text: Show the health overview of all seed accounts.
      - text: Report which seed mailboxes look broken.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk-upload custom seed accounts
      effect: write
      questions:
      - Can I upload many custom seed accounts at once?
      - Is there a bulk import for seed mailboxes?
      instructions:
      - text: Bulk-upload this batch of custom seed accounts.
      - text: Add a list of seed mailboxes in one request.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a seed account
      effect: write
      questions:
      - Can I change the details of an existing seed mailbox?
      - What fields on a seed account can be patched?
      instructions:
      - text: Update seed account {id} with the new settings.
        slots:
          id: path.id
      - text: Patch the configuration of seed {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/sync-ldm'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync seeds from LDM
      effect: write
      questions:
      - Can I sync the seed list from the LDM platform?
      - How are seed accounts kept in step with LDM?
      instructions:
      - text: Sync seed accounts from LDM now.
      - text: Run the LDM seed synchronization.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/ldm/control-accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List LDM control accounts
      effect: read
      questions:
      - Which LDM control accounts are available?
      - What control mailboxes exist on the LDM side?
      instructions:
      - text: List the LDM control accounts.
      - text: Show me every control account available from LDM.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/import-from-ldm'].post
  update:
    x-apievangelist-phrasing:
      intent: Import seeds from LDM
      effect: write
      questions:
      - Can I import LDM control accounts as new seeds?
      - Is there a one-time import of seeds from LDM?
      instructions:
      - text: Import seed accounts from LDM.
      - text: Pull LDM control accounts in as seeds.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/import-oauth-combo'].post
  update:
    x-apievangelist-phrasing:
      intent: Import Outlook combo seeds via OAuth
      effect: write
      questions:
      - Can I import Outlook combo seeds that authenticate with IMAP XOAUTH2?
      - Which import handles public-client Outlook seed accounts?
      instructions:
      - text: Import Outlook combo seeds using IMAP XOAUTH2.
      - text: Load public-client Outlook seed accounts from a combo list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/{id}/probe'].post
  update:
    x-apievangelist-phrasing:
      intent: Probe a seed account connection
      effect: write
      questions:
      - Can I test whether a single seed mailbox still connects?
      - How do I check one seed's login works?
      instructions:
      - text: Probe seed {id} to confirm it connects.
        slots:
          id: path.id
      - text: Run a connectivity check against seed account {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List mailbox providers
      effect: read
      questions:
      - Which mailbox providers are configured for placement testing?
      - What providers does the admin panel know about?
      instructions:
      - text: List all configured mailbox providers.
      - text: Show the provider catalog in admin.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a mailbox provider
      effect: write
      questions:
      - Can I add a new mailbox provider to the catalog?
      - How is a new provider registered for testing?
      instructions:
      - text: Create a new mailbox provider entry.
      - text: Register an additional provider in the catalog.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a mailbox provider
      effect: read
      questions:
      - What settings does a specific mailbox provider have?
      - Can I look up one provider by id?
      instructions:
      - text: Show mailbox provider {id}.
        slots:
          id: path.id
      - text: Fetch the details of provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a mailbox provider
      effect: destructive
      questions:
      - Can I remove a mailbox provider from the catalog?
      - What happens when a provider is deleted?
      instructions:
      - text: Delete mailbox provider {id}.
        slots:
          id: path.id
      - text: Remove provider {id} from the catalog.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a mailbox provider
      effect: write
      questions:
      - Can I edit an existing mailbox provider's settings?
      - Which provider fields can be patched?
      instructions:
      - text: Update mailbox provider {id}.
        slots:
          id: path.id
      - text: Patch the configuration of provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}/delivery-blocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a provider's delivery blocks
      effect: read
      questions:
      - Which delivery blocks are set on a mailbox provider?
      - Is delivery to a given provider currently blocked?
      instructions:
      - text: List delivery blocks for provider {id}.
        slots:
          id: path.id
      - text: Show what is blocking delivery to provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}/delivery-blocks'].post
  update:
    x-apievangelist-phrasing:
      intent: Block delivery to a provider
      effect: write
      questions:
      - Can I add a delivery block to a mailbox provider?
      - How do I stop sends going to one provider?
      instructions:
      - text: Add a delivery block to provider {id}.
        slots:
          id: path.id
      - text: Block outgoing delivery to mailbox provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}/delivery-blocks/{blockId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a delivery block
      effect: destructive
      questions:
      - Can I lift a delivery block from a provider?
      - What removes a single block from a provider's delivery blocks?
      instructions:
      - text: Remove delivery block {blockId} from provider {id}.
        slots:
          blockId: path.blockId
          id: path.id
      - text: Lift block {blockId} on mailbox provider {id}.
        slots:
          blockId: path.blockId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/{id}/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get statistics for one seed
      effect: read
      questions:
      - How has a particular seed mailbox performed?
      - Can I see only recent results for one seed account?
      instructions:
      - text: Show stats for seed {id}.
        slots:
          id: path.id
      - text: Give me the recent {recent} results for seed account {id}.
        slots:
          recent: query.recent
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/providers/{id}/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get statistics for a mailbox provider
      effect: read
      questions:
      - How is a given mailbox provider performing in tests?
      - What placement stats exist per provider?
      instructions:
      - text: Show the stats for provider {id}.
        slots:
          id: path.id
      - text: Report test performance for mailbox provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/seeds/health-check'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a seed health check
      effect: write
      questions:
      - Can I trigger a fresh health check across all seeds?
      - Does the seed health check cover inactive seeds too?
      instructions:
      - text: Run a seed health check now.
      - text: Run the seed health check with inactive seeds included set to {includeInactive}.
        slots:
          includeInactive: query.includeInactive
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/cleanup/imap'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger IMAP mailbox cleanup
      effect: destructive
      questions:
      - Can I force the IMAP cleanup job to run right away?
      - What clears old messages out of seed inboxes?
      instructions:
      - text: Trigger the IMAP cleanup now.
      - text: Run the seed inbox IMAP cleanup immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/bounces/process-now'].post
  update:
    x-apievangelist-phrasing:
      intent: Process bounces immediately
      effect: write
      questions:
      - Can I process pending bounces without waiting for the schedule?
      - How is bounce processing kicked off manually?
      instructions:
      - text: Process bounces now.
      - text: Run the bounce processor immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tests'].get
  update:
    x-apievangelist-phrasing:
      intent: List inbox placement tests
      effect: read
      questions:
      - Which inbox placement tests have run across the platform?
      - Can I search tests by text and filter by status?
      instructions:
      - text: List tests with status {status}.
        slots:
          status: query.status
      - text: Search inbox tests for {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tests/{token}/trace'].get
  update:
    x-apievangelist-phrasing:
      intent: Trace a test end to end
      effect: read
      questions:
      - Why did a specific inbox test behave oddly?
      - Can I see everything known about one test token, including per-seed results?
      instructions:
      - text: Trace test {token} end to end.
        slots:
          token: path.token
      - text: Show the debugging trace with per-seed placement for test {token}.
        slots:
          token: path.token
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues'].get
  update:
    x-apievangelist-phrasing:
      intent: View queue overview
      effect: read
      questions:
      - What do the background job queues look like right now?
      - Which queues have a backlog?
      instructions:
      - text: Show an overview of all job queues.
      - text: Report the depth of every background queue.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/visitors'].get
  update:
    x-apievangelist-phrasing:
      intent: Analyze site visitors
      effect: read
      questions:
      - Who has been visiting the site in the last few hours?
      - Can I filter visitors by agent, source or destination?
      instructions:
      - text: Show visitors from the last {hours} hours.
        slots:
          hours: query.hours
      - text: List visitors from source {source} matching {search}.
        slots:
          source: query.source
          search: query.search
      - text: Show visitors using agent {agent} on page {page}.
        slots:
          agent: query.agent
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/transport-health'].get
  update:
    x-apievangelist-phrasing:
      intent: Probe public transport endpoints
      effect: read
      questions:
      - Are the public transport endpoints up and how fast do they answer?
      - Can I measure server-side latency of each transport without TLS overhead?
      instructions:
      - text: Probe every public transport endpoint and report latency.
      - text: Check transport health end to end.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/protocol-stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get AI-agent transport traffic stats
      effect: read
      questions:
      - How much traffic are the MCP and A2A transports getting?
      - Are AI agents actually using the agent protocols?
      instructions:
      - text: Show {protocol} request traffic for the last {hours} hours.
        slots:
          protocol: query.protocol
          hours: query.hours
      - text: Report MCP and A2A protocol usage.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Read server logs
      effect: read
      questions:
      - Can I read the application logs from the admin panel?
      - Is it possible to filter logs by level or search text?
      instructions:
      - text: Show the last {lines} lines of the {stream} log.
        slots:
          lines: query.lines
          stream: query.stream
      - text: Find {level} log lines containing {q}.
        slots:
          level: query.level
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/operations-health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check operations health
      effect: read
      questions:
      - Is the platform operationally healthy?
      - What is the overall operations health status?
      instructions:
      - text: Show the operations health status.
      - text: Report on overall operational health.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys/scopes/structured'].get
  update:
    x-apievangelist-phrasing:
      intent: List API key scope catalog
      effect: read
      questions:
      - What scopes can an API key be granted?
      - Which scope presets exist and which scopes are flagged as dangerous?
      instructions:
      - text: List the structured API key scope catalog.
      - text: Show scope presets like readOnly and fullAuto.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List all API keys
      effect: read
      questions:
      - Which API keys exist across the platform?
      - Can an admin see every issued API key?
      instructions:
      - text: List all API keys.
      - text: Show every API key issued on the platform.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an API key
      effect: write
      questions:
      - Can I issue a new API key with daily and monthly limits?
      - What scopes and tier can a new key be created with?
      instructions:
      - text: Create an API key named {name}.
        slots:
          name: requestBody.name
      - text: Create key {name} on tier {tier} with a daily limit of {dailyLimit}.
        slots:
          name: requestBody.name
          tier: requestBody.tier
          dailyLimit: requestBody.dailyLimit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an API key
      effect: destructive
      questions:
      - Can I revoke an API key that leaked?
      - Is revoking a key a hard delete or a soft delete?
      instructions:
      - text: Revoke API key {id}.
        slots:
          id: path.id
      - text: Disable key {id} so it can no longer be used.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an API key
      effect: write
      questions:
      - Can I raise the monthly limit on an existing API key?
      - Is it possible to deactivate a key without revoking it?
      instructions:
      - text: Set the monthly limit of key {id} to {monthlyLimit}.
        slots:
          id: path.id
          monthlyLimit: requestBody.monthlyLimit
      - text: Set API key {id} active to {active}.
        slots:
          id: path.id
          active: requestBody.active
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/api-keys/{id}/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get API key usage
      effect: read
      questions:
      - How much has a particular API key been used?
      - Can I see key usage events within a date range?
      instructions:
      - text: Show usage for API key {id}.
        slots:
          id: path.id
      - text: Get usage events for key {id} from {from} to {to}.
        slots:
          id: path.id
          from: query.from
          to: query.to
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/dmarc/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize DMARC results
      effect: read
      questions:
      - How are our domains doing on DMARC overall?
      - What is the DMARC pass rate over the last few days?
      instructions:
      - text: Summarize DMARC results for the last {days} days.
        slots:
          days: query.days
      - text: Give me the DMARC summary.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/dmarc/sources'].get
  update:
    x-apievangelist-phrasing:
      intent: List DMARC sending sources
      effect: read
      questions:
      - Which IPs and sources are sending mail as our domains?
      - Can I see the top DMARC sources over a period?
      instructions:
      - text: List the top {limit} DMARC sending sources.
        slots:
          limit: query.limit
      - text: Show DMARC sources seen in the last {days} days.
        slots:
          days: query.days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/dmarc/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List DMARC aggregate reports
      effect: read
      questions:
      - Which DMARC aggregate reports have we received?
      - Can I filter DMARC reports by domain?
      instructions:
      - text: List DMARC reports for domain {domain}.
        slots:
          domain: query.domain
      - text: Show the last {limit} DMARC reports from the past {days} days.
        slots:
          limit: query.limit
          days: query.days
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/dmarc/reports/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DMARC report
      effect: read
      questions:
      - What is inside a specific DMARC report?
      - Can I open one DMARC report by id?
      instructions:
      - text: Open DMARC report {id}.
        slots:
          id: path.id
      - text: Show the records in DMARC report {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/dmarc/poll'].post
  update:
    x-apievangelist-phrasing:
      intent: Poll for new DMARC reports
      effect: write
      questions:
      - Can I fetch new DMARC reports immediately?
      - How do I trigger a DMARC mailbox poll?
      instructions:
      - text: Poll for new DMARC reports now.
      - text: Check the DMARC inbox for fresh reports.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/account-transfers/plan'].post
  update:
    x-apievangelist-phrasing:
      intent: Dry-run an account transfer
      effect: read
      questions:
      - Can I preview what moving accounts between tenant databases would do?
      - What does an account transfer dry-run return before anything changes?
      instructions:
      - text: Plan a transfer of {resources} from {sourceEmails} to {targetEmail}.
        slots:
          resources: requestBody.resources
          sourceEmails: requestBody.sourceEmails
          targetEmail: requestBody.targetEmail
      - text: Dry-run moving accounts {sourceEmails} into {targetEmail} for {resources}.
        slots:
          sourceEmails: requestBody.sourceEmails
          targetEmail: requestBody.targetEmail
          resources: requestBody.resources
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/account-transfers/apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply a confirmed account transfer
      effect: write
      questions:
      - How do I carry out an account transfer once the plan is confirmed?
      - Is applying an account transfer idempotent?
      instructions:
      - text: Apply transfer plan {planHash} as operation {operationId} from {sourceEmails} to {targetEmail} for {resources}.
        slots:
          planHash: requestBody.planHash
          operationId: requestBody.operationId
          sourceEmails: requestBody.sourceEmails
          targetEmail: requestBody.targetEmail
          resources: requestBody.resources
      - text: Execute account transfer {operationId} with reason {reason}.
        slots:
          operationId: requestBody.operationId
          reason: requestBody.reason
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/account-transfers/{operationId}/deactivate-sources'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate source users after a transfer
      effect: destructive
      questions:
      - Can I deactivate the old users once their account transfer is done?
      - What happens to source accounts after a completed transfer?
      instructions:
      - text: Deactivate source users {sourceEmails} of transfer {operationId} now merged into {targetEmail}.
        slots:
          sourceEmails: requestBody.sourceEmails
          operationId: path.operationId
          targetEmail: requestBody.targetEmail
      - text: Disable the source accounts of completed transfer {operationId} because {reason}.
        slots:
          operationId: path.operationId
          reason: requestBody.reason
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/account-transfers/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an account transfer's status
      effect: read
      questions:
      - Did a particular account transfer finish?
      - Where is the audit status of a transfer operation?
      instructions:
      - text: Show the status of account transfer {operationId}.
        slots:
          operationId: path.operationId
      - text: Get the audit record for transfer operation {operationId}.
        slots:
          operationId: path.operationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{id}/freeze'].post
  update:
    x-apievangelist-phrasing:
      intent: Freeze a tenant's sending
      effect: destructive
      questions:
      - Can I stop a tenant from sending any email immediately?
      - What does freezing a tenant do to its campaigns?
      instructions:
      - text: Freeze tenant {id} now.
        slots:
          id: path.id
      - text: Halt all sending for tenant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{id}/unfreeze'].post
  update:
    x-apievangelist-phrasing:
      intent: Unfreeze a tenant
      effect: write
      questions:
      - Can a frozen tenant be allowed to send again?
      - How is sending resumed after a freeze?
      instructions:
      - text: Unfreeze tenant {id}.
        slots:
          id: path.id
      - text: Resume sending for frozen tenant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{id}/legal-hold'].post
  update:
    x-apievangelist-phrasing:
      intent: Set or clear a tenant legal hold
      effect: write
      questions:
      - Can I pause data purging for a tenant under legal hold?
      - What does a legal hold change about TTL cleanup?
      instructions:
      - text: Put tenant {id} on legal hold.
        slots:
          id: path.id
      - text: Clear the legal hold on tenant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/suppression/global/retro-release'].post
  update:
    x-apievangelist-phrasing:
      intent: Release stale global suppressions
      effect: write
      questions:
      - Can I lift global suppression for addresses that never hard-bounced?
      - Which suppressed addresses qualify for a retroactive release?
      instructions:
      - text: Retro-release global suppressions for policy, routing and soft addresses.
      - text: Unsuppress addresses with no hard or inactive status anywhere on the platform.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/scoring/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check scoring pipeline health
      effect: read
      questions:
      - Is the scoring pipeline's browser worker reachable?
      - How deep are the scoring queues right now?
      instructions:
      - text: Show scoring pipeline health.
      - text: Report browser worker reachability and scoring queue depths.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List jobs in a queue
      effect: read
      questions:
      - Which jobs are sitting in a given queue?
      - Can I list failed jobs in a queue within an index range?
      instructions:
      - text: List {status} jobs in queue {name} from {start} to {end}.
        slots:
          status: query.status
          name: path.name
          start: query.start
          end: query.end
      - text: Show the {status} jobs waiting in queue {name}.
        slots:
          status: query.status
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/pause'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause a job queue
      effect: write
      questions:
      - Can I pause a BullMQ queue so it stops processing?
      - What stops workers from picking jobs off one queue?
      instructions:
      - text: Pause queue {name}.
        slots:
          name: path.name
      - text: Stop processing on the {name} queue.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused queue
      effect: write
      questions:
      - Can a paused BullMQ queue be restarted?
      - How do workers start consuming a paused queue again?
      instructions:
      - text: Resume queue {name}.
        slots:
          name: path.name
      - text: Restart processing on paused queue {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/jobs/{id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a queue job
      effect: destructive
      questions:
      - Can I cancel a single job stuck in a queue?
      - What removes one job by id from a queue?
      instructions:
      - text: Cancel job {id} in queue {name}.
        slots:
          id: path.id
          name: path.name
      - text: Kill queued job {id} on {name}.
        slots:
          id: path.id
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/jobs/{id}/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry a failed queue job
      effect: write
      questions:
      - Can I retry a job that failed?
      - Is there a way to re-run one failed job by id?
      instructions:
      - text: Retry failed job {id} in queue {name}.
        slots:
          id: path.id
          name: path.name
      - text: Re-run job {id} on the {name} queue.
        slots:
          id: path.id
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/queues/{name}/clean'].post
  update:
    x-apievangelist-phrasing:
      intent: Clean completed or failed queue jobs
      effect: destructive
      questions:
      - Can I clear out completed and failed jobs from a queue?
      - How do I purge finished jobs to shrink a queue?
      instructions:
      - text: Clean completed and failed jobs from queue {name}.
        slots:
          name: path.name
      - text: Purge finished jobs on the {name} queue.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/storage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get storage usage
      effect: read
      questions:
      - How much storage is the platform using?
      - What are the current disk storage stats?
      instructions:
      - text: Show storage usage stats.
      - text: Report how much storage space is consumed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/storage/pdfs'].get
  update:
    x-apievangelist-phrasing:
      intent: List stored PDFs
      effect: read
      questions:
      - Which PDFs are kept in storage?
      - Can I see metadata for every stored PDF?
      instructions:
      - text: List stored PDFs with their metadata.
      - text: Show all PDF files held in storage.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/storage/cleanup-pdfs'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete old stored PDFs
      effect: destructive
      questions:
      - Can I free space by deleting old PDFs?
      - What cleans up aged PDF files in storage?
      instructions:
      - text: Clean up old PDFs from storage.
      - text: Delete stale PDF files to reclaim space.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants'].get
  update:
    x-apievangelist-phrasing:
      intent: List all tenants
      effect: read
      questions:
      - Which tenants exist on the platform?
      - Can an admin see metadata for every tenant workspace?
      instructions:
      - text: List all tenants with metadata.
      - text: Show every tenant workspace.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/ldm-ai'].patch
  update:
    x-apievangelist-phrasing:
      intent: Toggle LDM AI for a tenant
      effect: write
      questions:
      - Can I switch LDM AI on or off for one tenant?
      - How is the AI feature enabled per workspace?
      instructions:
      - text: Toggle LDM AI for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Turn LDM AI off for workspace {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/campaigns/{dbName}/{id}/audit-unblock'].patch
  update:
    x-apievangelist-phrasing:
      intent: Unblock an audit-blocked campaign
      effect: write
      questions:
      - Can a moderator release a campaign stuck in AUDIT_BLOCKED?
      - What state does a campaign land in after a manual audit unblock?
      instructions:
      - text: Unblock audit-blocked campaign {id} in tenant {dbName}.
        slots:
          id: path.id
          dbName: path.dbName
      - text: Reset audit iterations on campaign {id} for {dbName} and set it paused.
        slots:
          id: path.id
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/ldm-ai/balance'].patch
  update:
    x-apievangelist-phrasing:
      intent: Top up a tenant's LDM AI balance
      effect: write
      questions:
      - Can I add USD credit to a tenant's LDM AI balance?
      - How is a workspace's AI balance set?
      instructions:
      - text: Top up the LDM AI balance for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Set the AI credit balance of {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/db-quota'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant's database quota
      effect: read
      questions:
      - How close is a tenant to its database quota?
      - What DB size limit does a workspace have?
      instructions:
      - text: Show the DB quota and usage for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Check database usage against quota for {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/db-quota'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set a tenant's database quota
      effect: write
      questions:
      - Can I raise a tenant's database quota in MB?
      - Is it possible to give a workspace an unlimited DB quota?
      instructions:
      - text: Set the DB quota for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Make the database quota of {dbName} unlimited.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/email-accounts-max'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant's email account cap
      effect: read
      questions:
      - How many email accounts can a tenant connect?
      - How many sending mailboxes is a workspace using against its cap?
      instructions:
      - text: Show the email accounts cap and usage for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Check how many email accounts {dbName} has against its limit.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/email-accounts-max'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set a tenant's email account cap
      effect: write
      questions:
      - Can I let a tenant connect more email accounts?
      - Can a workspace's mailbox cap be reset to the platform default?
      instructions:
      - text: Change the email accounts cap for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Reset {dbName} to the platform default mailbox limit.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/max-streams'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set a tenant's parallel send streams
      effect: write
      questions:
      - Can I change how many parallel streams a tenant sends with?
      - Where is a workspace's max concurrency for sending set?
      instructions:
      - text: Update max parallel streams for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Change the send stream limit of {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/transport'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a tenant's mail transport
      effect: write
      questions:
      - Can I change which mail transport a tenant uses?
      - Where is a workspace's outbound mail transport configured?
      instructions:
      - text: Update the mail transport config for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Switch the outbound transport of {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/settings-menu'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant's hidden settings tabs
      effect: read
      questions:
      - Which settings-menu tabs are hidden for a tenant?
      - Can I see what settings a workspace cannot view?
      instructions:
      - text: Show hidden settings-menu tabs for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: List the settings tabs hidden from {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/settings-menu'].patch
  update:
    x-apievangelist-phrasing:
      intent: Hide settings tabs for a tenant
      effect: write
      questions:
      - Can I hide certain settings-menu tabs from a tenant?
      - How do I change which settings tabs a workspace sees?
      instructions:
      - text: Set the hidden settings-menu tabs for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Update which settings tabs {dbName} can no longer see.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/inbox-check'].get
  update:
    x-apievangelist-phrasing:
      intent: List inbox-check status across tenants
      effect: read
      questions:
      - Which tenants have inbox-check enabled?
      - What is the inbox-check status for every workspace?
      instructions:
      - text: List inbox-check status for all tenants.
      - text: Show which workspaces use inbox checking.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/inbox-check'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tenant's inbox-check config
      effect: write
      questions:
      - Can I change the inbox-check settings for one tenant?
      - Where is a workspace's inbox-check configuration edited?
      instructions:
      - text: Update inbox-check config for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Change the inbox-check settings of {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/inbox-check/connect'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect paid Inbox Placement for a workspace
      effect: write
      questions:
      - Can I connect paid Inbox Placement to a user workspace in one step?
      - Is connecting Inbox Placement atomic?
      instructions:
      - text: Connect paid Inbox Placement for workspace {dbName}.
        slots:
          dbName: path.dbName
      - text: Activate the paid Inbox Placement add-on for {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/tenants/{dbName}/inbox-check/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an inbox-check test for a tenant
      effect: write
      questions:
      - Can I run a test inbox check on behalf of a tenant?
      - Does inbox checking work for a given workspace?
      instructions:
      - text: Run an inbox-check test for tenant {dbName}.
        slots:
          dbName: path.dbName
      - text: Test inbox checking on workspace {dbName}.
        slots:
          dbName: path.dbName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/ldmai-usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get LDM AI usage statistics
      effect: read
      questions:
      - How much is LDM AI being used?
      - What do LDM AI usage statistics show?
      instructions:
      - text: Show LDM AI usage statistics.
      - text: Report AI usage across the platform.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/ldmai-queue'].get
  update:
    x-apievangelist-phrasing:
      intent: View the LDM AI queue
      effect: read
      questions:
      - Is the LDM AI queue backed up?
      - What is waiting in the AI job queue right now?
      instructions:
      - text: Show a snapshot of the LDM AI queue.
      - text: Report pending jobs in the AI queue.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/ai-monitor'].get
  update:
    x-apievangelist-phrasing:
      intent: Monitor AI calls
      effect: read
      questions:
      - Which AI calls failed for a tenant recently?
      - Can I filter AI monitor data by provider and context?
      instructions:
      - text: Show AI monitor data for provider {provider} in context {context} for tenant {tenant}.
        slots:
          provider: query.provider
          context: query.context
          tenant: query.tenant
      - text: List AI calls with success {success} over {days} days, {limit} per page from {offset}.
        slots:
          success: query.success
          days: query.days
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/ai-model-mapping'].get
  update:
    x-apievangelist-phrasing:
      intent: View AI model mapping
      effect: read
      questions:
      - Which AI models are mapped to which tasks?
      - What does the AI model mapping configuration look like?
      instructions:
      - text: Show the AI model mapping configuration.
      - text: List which model handles each AI task.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/i18n'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the translations bundle
      effect: read
      questions:
      - Where can I read the full set of UI translations?
      - What is in the i18n bundle?
      instructions:
      - text: Get the i18n translations bundle.
      - text: Show all interface translation strings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/i18n/key'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one translation key
      effect: write
      questions:
      - Can I fix the text of a single translation key?
      - How is one UI string's translation edited?
      instructions:
      - text: Update a single i18n translation key.
      - text: Change the text of one translation string.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/i18n/key'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a translation key
      effect: destructive
      questions:
      - Can I remove a translation key that is no longer used?
      - What deletes an i18n string?
      instructions:
      - text: Delete an i18n translation key.
      - text: Remove an obsolete translation string.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/i18n/bulk'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk-update translations
      effect: write
      questions:
      - Can I update many translation keys at once?
      - Is there a bulk edit for i18n strings?
      instructions:
      - text: Bulk-update these i18n translation keys.
      - text: Apply a batch of translation changes in one request.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory'].get
  update:
    x-apievangelist-phrasing:
      intent: List memory files
      effect: read
      questions:
      - Which memory files are stored?
      - Can an admin see all the memory files by name?
      instructions:
      - text: List all memory files.
      - text: Show the names of stored memory files.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get memory storage stats
      effect: read
      questions:
      - How much space do memory files take up?
      - What are the memory storage statistics?
      instructions:
      - text: Show memory storage stats.
      - text: Report the total size and count of memory files.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory/{filename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a memory file
      effect: read
      questions:
      - What does a particular memory file contain?
      - Can I open one memory file by its filename?
      instructions:
      - text: Read memory file {filename}.
        slots:
          filename: path.filename
      - text: Show the contents of {filename} from memory.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory/{filename}'].put
  update:
    x-apievangelist-phrasing:
      intent: Write a memory file
      effect: write
      questions:
      - Can I create or overwrite a memory file?
      - How is content saved into a named memory file?
      instructions:
      - text: Write memory file {filename} with this content.
        slots:
          filename: path.filename
      - text: Save new contents into {filename} in memory.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory/{filename}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a memory file
      effect: destructive
      questions:
      - Can I delete a memory file I no longer need?
      - What permanently removes a memory file?
      instructions:
      - text: Delete memory file {filename}.
        slots:
          filename: path.filename
      - text: Remove {filename} from memory storage.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/memory/rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a memory file
      effect: write
      questions:
      - Can I rename a memory file?
      - How is a memory file given a new name?
      instructions:
      - text: Rename a memory file to a new name.
      - text: Give an existing memory file a different filename.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: View the security overview
      effect: read
      questions:
      - What does the server security dashboard show?
      - Is there one view summarizing the platform's security posture?
      instructions:
      - text: Show the security overview dashboard.
      - text: Give me the security posture at a glance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/ports'].get
  update:
    x-apievangelist-phrasing:
      intent: List open network ports
      effect: read
      questions:
      - Which network ports are open on the host?
      - Are any unexpected ports exposed on the server?
      instructions:
      - text: List open network ports on the host.
      - text: Show which server ports are listening.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/score'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the security score
      effect: read
      questions:
      - What is our aggregate security score?
      - How secure does the server rate overall?
      instructions:
      - text: Show the aggregate security score.
      - text: Report the current security rating.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get security hardening recommendations
      effect: read
      questions:
      - What should we harden on the server?
      - Which security recommendations are outstanding?
      instructions:
      - text: List security hardening recommendations.
      - text: Show what to fix to harden the server.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/integrity'].get
  update:
    x-apievangelist-phrasing:
      intent: Check file integrity against baseline
      effect: read
      questions:
      - Have any files changed since the integrity baseline?
      - Is the file-integrity check clean?
      instructions:
      - text: Compare files against the integrity baseline.
      - text: Show file-integrity drift from the baseline.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/baseline'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a file-integrity baseline
      effect: write
      questions:
      - Can I record a new file-integrity baseline after a deploy?
      - How is the integrity baseline reset?
      instructions:
      - text: Create a new file-integrity baseline.
      - text: Snapshot current files as the integrity baseline.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/check'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an on-demand security check
      effect: write
      questions:
      - Can I run a security check right now instead of waiting?
      - How do I trigger an on-demand security scan?
      instructions:
      - text: Run an on-demand security check.
      - text: Kick off a security scan immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/intrusions'].get
  update:
    x-apievangelist-phrasing:
      intent: List detected intrusion attempts
      effect: read
      questions:
      - Has anyone tried to break into the server lately?
      - Can I list intrusion attempts within a time window?
      instructions:
      - text: List up to {limit} intrusion attempts from the last {hours} hours.
        slots:
          limit: query.limit
          hours: query.hours
      - text: Show intrusion attempts in the past {hours} hours.
        slots:
          hours: query.hours
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the security attack summary
      effect: read
      questions:
      - What attacks hit the platform in the last day?
      - Is there a summary report of attacks over a period?
      instructions:
      - text: Summarize attacks over the last {hours} hours.
        slots:
          hours: query.hours
      - text: Give me the security summary report for {hours} hours.
        slots:
          hours: query.hours
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/honeypot'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent honeypot events
      effect: read
      questions:
      - What has the honeypot caught recently?
      - Can I see the latest honeypot hits?
      instructions:
      - text: List the last {limit} honeypot events.
        slots:
          limit: query.limit
      - text: Show {limit} recent honeypot trap hits.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/honeypot/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get honeypot statistics
      effect: read
      questions:
      - How many honeypot hits have there been in total?
      - What do aggregate honeypot statistics show?
      instructions:
      - text: Show aggregate honeypot statistics.
      - text: Report honeypot totals by type.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/lockdown'].get
  update:
    x-apievangelist-phrasing:
      intent: Check lockdown status
      effect: read
      questions:
      - Is the platform in lockdown mode right now?
      - What is the current lockdown state?
      instructions:
      - text: Show the current lockdown state.
      - text: Tell me whether lockdown is active.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/lockdown/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate lockdown mode
      effect: write
      questions:
      - Can I put the platform into lockdown during an attack?
      - What turns on lockdown mode?
      instructions:
      - text: Activate lockdown mode.
      - text: Lock the platform down now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/lockdown/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate lockdown mode
      effect: write
      questions:
      - Can I lift lockdown once the threat has passed?
      - What ends lockdown mode?
      instructions:
      - text: Deactivate lockdown mode.
      - text: Lift the platform lockdown.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/lockdown/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View lockdown history
      effect: read
      questions:
      - When has lockdown been switched on in the past?
      - Is there a history of lockdown activations?
      instructions:
      - text: Show the lockdown activation history.
      - text: List past lockdown events.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List security events
      effect: read
      questions:
      - What security events have been logged recently?
      - Can I read the security events log?
      instructions:
      - text: List the last {limit} security events.
        slots:
          limit: query.limit
      - text: Show {limit} entries from the security log.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/cross-tenant-denied'].get
  update:
    x-apievangelist-phrasing:
      intent: Review denied cross-tenant access
      effect: read
      questions:
      - Has anyone tried to reach another tenant's data?
      - Can I group denied cross-tenant requests by actor and target tenant?
      instructions:
      - text: Aggregate cross-tenant denied events over the last {hours} hours.
        slots:
          hours: query.hours
      - text: Show blocked cross-tenant access attempts by actor for {hours} hours.
        slots:
          hours: query.hours
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/security/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List available backups
      effect: read
      questions:
      - Which backups are available to restore from?
      - When was the last backup taken?
      instructions:
      - text: List available backups.
      - text: Show the backup status.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/alert-canary'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the alert canary
      effect: read
      questions:
      - Is the system alert channel still delivering?
      - How many consecutive failures has the alert canary had?
      instructions:
      - text: Show the alert canary status.
      - text: Report the last successful alert canary tick.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/alert-canary/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the alert canary manually
      effect: write
      questions:
      - Can I fire a test alert through the system alert channel?
      - How do I run one canary tick by hand?
      instructions:
      - text: Run one alert canary tick now.
      - text: Send a canary through the system alert channel.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/pipelines'].get
  update:
    x-apievangelist-phrasing:
      intent: List pipelines across tenants
      effect: read
      questions:
      - Which pipelines exist across every tenant?
      - Is there a cross-tenant admin view of pipelines?
      instructions:
      - text: List all pipelines across tenants.
      - text: Show every tenant's pipelines in one view.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/agent-guide/overrides'].get
  update:
    x-apievangelist-phrasing:
      intent: Get agent-guide overrides
      effect: read
      questions:
      - What overrides have been applied to the agent guide?
      - Can I see the raw agent-guide overlay JSON?
      instructions:
      - text: Show the editable agent-guide overrides.
      - text: Get the raw agent-guide overlay with its meta.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/agent-guide/overrides'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace agent-guide overrides
      effect: write
      questions:
      - Can I replace the agent-guide overrides for domains and operations?
      - What happens to override fields I leave out?
      instructions:
      - text: Replace agent-guide domain overrides with {domains}.
        slots:
          domains: requestBody.domains
      - text: Set agent-guide operation overrides to {operations} and controller domain to {controllerDomain}.
        slots:
          operations: requestBody.operations
          controllerDomain: requestBody.controllerDomain
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/agent-guide/effective'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview the effective agent guide
      effect: read
      questions:
      - What does the agent guide look like with defaults and overrides merged?
      - Can I preview the effective guide map?
      instructions:
      - text: Preview the effective agent guide map.
      - text: Show the agent guide after overrides are applied.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/agent-guide/coverage'].get
  update:
    x-apievangelist-phrasing:
      intent: Report agent-guide coverage
      effect: read
      questions:
      - How many MCP tools have operation-level guidance?
      - Which MCP tools fall back to domain guidance or have none?
      instructions:
      - text: Show the agent guidance coverage report.
      - text: Report MCP tools missing operation-level guidance.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/billing/tenants'].get
  update:
    x-apievangelist-phrasing:
      intent: List tenant billing balances
      effect: read
      questions:
      - What balance does each tenant have?
      - How much has each workspace been charged over 30 days?
      instructions:
      - text: List billing balances for all tenants.
      - text: Show each tenant's balance and 30-day charges.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/billing/tenants/{dbName}/ledger'].get
  update:
    x-apievangelist-phrasing:
      intent: View a tenant's billing ledger
      effect: read
      questions:
      - What charges and credits has a tenant had?
      - Can I filter a tenant's ledger to only refunds?
      instructions:
      - text: Show {entryType} ledger entries for tenant {dbName}.
        slots:
          entryType: query.entryType
          dbName: path.dbName
      - text: Get {limit} ledger movements for {dbName} after cursor {cursor}.
        slots:
          limit: query.limit
          dbName: path.dbName
          cursor: query.cursor
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/billing/pricing'].get
  update:
    x-apievangelist-phrasing:
      intent: View platform pricing
      effect: read
      questions:
      - What does each billable operation cost?
      - What signup credit do new users get?
      instructions:
      - text: Show the platform price registry.
      - text: List effective prices and the signup credit.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/billing/pricing'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change platform pricing
      effect: write
      questions:
      - Can I change the USD price of a billable operation?
      - Can an operation's price be reverted to the code default?
      instructions:
      - text: Update the platform price for an operation.
      - text: Change the signup credit amount in the price registry.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/support/threads'].get
  update:
    x-apievangelist-phrasing:
      intent: List support threads
      effect: read
      questions:
      - Which support conversations are open?
      - Can I filter support threads by status?
      instructions:
      - text: List support threads with status {status}.
        slots:
          status: query.status
      - text: Show all {status} support conversations.
        slots:
          status: query.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/support/unread-count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count unread support messages
      effect: read
      questions:
      - How many unread support messages are waiting?
      - Are there user messages nobody has read yet?
      instructions:
      - text: Count unread support messages.
      - text: Tell me the total unread user messages.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/support/threads/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Open a support thread
      effect: read
      questions:
      - What has a user written in a support thread?
      - Does opening a support thread mark it as read?
      instructions:
      - text: Open support thread {id}.
        slots:
          id: path.id
      - text: Show all messages in support thread {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/support/threads/{id}/reply'].post
  update:
    x-apievangelist-phrasing:
      intent: Reply to a support thread
      effect: write
      questions:
      - Can I reply to a user's support request?
      - Can a support reply include JPG or PNG attachments?
      instructions:
      - text: Reply to support thread {id} with {body}.
        slots:
          id: path.id
          body: requestBody.body
      - text: Send {body} with screenshots {files} on thread {id}.
        slots:
          body: requestBody.body
          files: requestBody.files
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/admin/support/threads/{id}/status'].post
  update:
    x-apievangelist-phrasing:
      intent: Close or reopen a support thread
      effect: write
      questions:
      - Can I close a support thread once it is resolved?
      - Is it possible to reopen a closed support conversation?
      instructions:
      - text: Close support thread {id}.
        slots:
          id: path.id
      - text: Reopen support thread {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'