# 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 Agent Card API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-agent-card-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: 8
- target: $.paths['/api/v1/agent-guide'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the agent capability guide
      effect: read
      questions:
      - What can an MCP or A2A agent do on this platform and in what order?
      - Is there a capability map with recommended flows for agents?
      instructions:
      - text: Fetch the expert agent guide with recommended flows.
      - text: Show the capability map for agents.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/agent-guide/context'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tenant's recent lists, briefs and tasks
      effect: read
      questions:
      - Which lists, briefs and tasks has my workspace worked on recently?
      - What tenant context should an agent load first?
      instructions:
      - text: Load the current tenant context core.
      - text: Show my recent lists, briefs and tasks for an agent.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/agent-guide/resume'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resume snapshot with the next step
      effect: read
      questions:
      - Where did my agent leave off and what should it do next?
      - Can an agent see its own recent notifications and self-notes when resuming?
      instructions:
      - text: Get the resume snapshot with the suggested next step.
      - text: Show where the agent left off, including its self-notes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/agent-guide/campaign-sender-capability'].get
  update:
    x-apievangelist-phrasing:
      intent: Run the sender-assignment preflight for campaigns
      effect: read
      questions:
      - What do I need before an agent changes a campaign's sender config or send window?
      - How does an agent get the receipt required for sender assignment writes?
      instructions:
      - text: Run the SDR campaign sender capability preflight.
      - text: Get the sender-assignment contract and receipt before editing senders.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check public v1 API health
      effect: read
      questions:
      - Is the public v1 API up?
      - How can an agent confirm the versioned public API is responding?
      instructions:
      - text: Check the public v1 API health endpoint.
      - text: Ping the v1 API to see if it is healthy.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/.well-known/agent-card.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the proprietary agent card
      effect: read
      questions:
      - Where is the LDM agent card that lists the platform's capabilities?
      - Can I get the full catalog instead of the curated subset in the LDM agent card?
      instructions:
      - text: Fetch the LDM agent card with full set to {full}.
        slots:
          full: query.full
      - text: Get the curated LDM-proprietary agent card.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/.well-known/agent.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the A2A-compliant agent card
      effect: read
      questions:
      - Does this platform publish an A2A 0.2.5 agent card?
      - How do I get every skill in the A2A agent.json rather than the curated ones?
      instructions:
      - text: Fetch the A2A agent.json card.
      - text: Get the A2A agent card with full set to {full}.
        slots:
          full: query.full
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/.well-known/oauth-protected-resource'].get
  update:
    x-apievangelist-phrasing:
      intent: Get OAuth protected resource metadata
      effect: read
      questions:
      - Does the API publish RFC 9728 protected resource metadata?
      - How should an automated client authenticate if there is no OAuth server?
      instructions:
      - text: Fetch the OAuth protected resource metadata document.
      - text: Show how automatable clients should bootstrap auth per RFC 9728.
      method: generated
      generated: '2026-10-01'